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PREFACE 



This manual describes the SCOPE 3.4 Operating System for the CONTROL DATA® CYBER 70/Models 72, 73 and 
74 and 6000 Series computers. It is written for systems programmers who perform system evaluation or program 
modification. 

Other documents of interest to system programmers using 3.4: 

SCOPE 3.4 Reference Manual 

SCOPE 3.4 Operator's Guide 

Record Manager Reference Manual 

LOADER Reference Manual 

UPDATE Reference Manual 

SCOPE 3.4 Installation Handbook 

The SCOPE 3.4 Internal Maintenance Specifications are not published; they are available, however, on listable mag- 
netic tape. 

SCOPE 3.4 is an extension of SCOPE 3.3. It includes the following new features and changes: 

User library creation and maintenance similar to EDITLIB creation of system libraries 

Support of SCOPE format records on 9-track tape 

New loader with associated restructuring of SCOPE system libraries and overlay/segment structures 

Revised REQUEST control statement parameters 

Addition of VSN card to support automatic tape assignment to requesting jobs 

Extended error processing 

Addition of sequential disk pack capabilities for highspeed access to a sequential file 

Renaming of private disk packs to family disk packs 

Additional permanent file functions: ALTER, SETP; additional parameters for other permanent 
file functions 

Replacement of SNAP and TRACE debugging aids 
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New extended core storage system 
Addition of Record Manager 
Addition of Integrated Scheduler 
Addition of File Organizer and Record Manager utilities 
Reorganization of system Monitor and CIO 
Common files are no longer supported 
Numeric values given in this document, unless otherwise indicated, are assumed to be as follows: 
Bit numbers Decimal 

Byte numbers Decimal 

Word addresses Octal 

Field/table lengths Octal 

Block/page sizes Octal 
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SCOPE 3.4 INTRODUCTION 



The operating system for CONTROL DATA® CYBER 70/Models 72, 73 and 74, and the 6000 Series computers 
provides Supervisory Control of Program Execution (SCOPE). The SCOPE operating system controls the use of 
CONTROL DATA CYBER 70/Models 72, 73 and 74, and 6000 Series computer hardware. Therefore, SCOPE is in 
control of the computer. SCOPE accepts input in the form of jobs submitted by users and processes them as directed 
by control cards accompanying each job as well as by keyboard commands input by the operator. 

Efficient processing of user's jobs is the prime objective of the operating system. This section describes the 
inherent hardware characteristics, the basic software elements, and how they work together to accomplish 
the prime objective. 

HARDWARE CHARACTERISTICS 

SCOPE uses peripheral processor units (PP) for system and input/output tasks and a central processor unit 
(CPU) to execute user and system jobs. Central memory (CM) contains user programs; system software 
areas are located at the upper and lower ends of central memory. An extended core storage (ECS) unit may 
be used to contain SCOPE libraries and other items (such as file buffers for RMS and swap files) which 
may not be contained in CM or on other mass storage devices. 

CENTRAL PROCESSOR 

The CPU is designed to perform tasks of a computational nature; it has no input/output capability. It 
communicates with other system components through the central memory. Under SCOPE, the CPU is used 
almost exclusively for program compilations, assemblies, and executions. The CPU makes system requests 
through a CPU request register located at the reference address plus one (RA+ 1) of the current program 
in execution. 

PERIPHERAL PROCESSORS 

The peripheral processors, of which there may be up to 20 (identified as PP0, PP1, . . . PPn) are identi- 
cal; they perform many tasks for requesting programs in central memory. 

A PP can be assigned to control, input/output, job scheduling, control card interpreting, system housekeep- 
ing and other tasks as required. Tasks are assigned one at a time to each PP by the system monitor (MTR). 
When an assigned task is completed, the PP signals the system. MTR waits for this signal before assigning 
another task to the PP. 

Each PP is assigned a block of eight words in the system area of central memory through which communi- 
cations with the system are conducted. Each block contains an input register, an output register, and a 
message buffer. Peripheral processors are discussed in section 3. 



60306500 A 1-1 



CENTRAL MEMORY 



Central memory words are 60 bits long; each has five 12-bit PP memory words, called bytes. Each 12-bit 
byte in a CM word is numbered through 4, from left to right: 



59 



48 47 



36 35 



24 23 



1211 



byteO 


byte 1 


byte 2 


byte 3 


byte 4 



One or more user programs may be in some state of execution concurrently under SCOPE. These programs 
are stored in central memory in an assigned user area; a set of system components necessary for the 
operation of the system is also stored in central memory, forming the central memory resident (CMR) and 
the record block table (RBT) areas. Central memory is accessible by all PPU's and CPU's and forms the 
communications link between all processor units in the computer system. 

Central memory resident (CMR) contains system communications areas, system tables, CPU resident rou- 
tines, the library directory, and information about each job currently in execution. The CMR is discussed in 
section 2 of this manual; the RBT is discussed in section 4. 

EXTENDED CORE STORAGE 

FEATURES 

Under SCOPE 3.4, Extended Core Storage (ECS) is divided into three areas: the System Area, the Dynamic 
Area, and the Direct Access area. They function as follows: 



System Area 
Dynamic Area 

Direct Access Area 



Contains system pointers and tables required by ECS software 

Paged area; contains buffers, library programs, swap files and other 
files assigned to ECS 

Assigned to user as result of job card request; used and managed by 
requestor 



Such division of ECS allows the following features to be provided: 

I/O buffering through ECS 

Library residence in ECS 

Job swapping to/from ECS by the Integrated Scheduler 

Compatibility with BNL-ECS 
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ECS PAGING 

I/O buffering through ECS with variable size buffers is made possible by the paging of ECS. Deadstart/ 
Installation parameters define the ECS page size buffer size. IP.EPAG sets the page size and has a default 
value of 8 PRU (1000 CM words); IP.EBUF determines the ECS buffer size and has a default value of 16 
(decimal) pages. 

ECS paging provides the following advantages: 

More efficient usage of ECS through dynamic allocation/deallocation of space 

Availability of ECS to more users by allowing the use of an "over-commitment" algorithm for ECS 

Simplification of core management by eliminating garbage collection chores 

SOFTWARE ELEMENTS 

Two elements are basic to the SCOPE operating system: files and control points. 

FILES 

A file is an organized collection of data known to the system by a given name. Data is organized in one or 
more logical records and terminated by an end-of-file indicator. Under the SCOPE operating system, the 
jobs it processes and all intermediate and final results are contained in files or parts of files. Files are 
discussed in section 4. 

CONTROL POINTS 

The system can control execution of several jobs at one time. When placed into CM before execution, each 
job is assigned a value which is the control point number and the index to a control point. Jobs at control 
points are assigned to a processor for execution. Each control point has a control point area in the CMR 
which holds all information necessary to process the assigned job. The control point concept is discussed in 
section 2. 

SCOPE ORGANIZATION 

The SCOPE operating system consists of PP programs, CP programs, macro definitions and symbol defini- 
tions. The entire system is contained in a magnetic tape file produced by the library maintenance program 
UPDATE. Programs in the library file are in source language form. Installation options are provided to 
permit flexible selection of system features during the assembly and creation of a deadstart file on tape. 

A system monitor is in complete supervisory control of the hardware system. The system monitor is made 
up of PP overlay OV.MTR which operates in PPO, and CPMTR which is assembled as part of the central 
memory resident (CMR). 
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SYSTEM LOADING 

To load the operating system into a CYBER 70 or 6000 series computer, the deadstart tape is mounted on a 
device and a small bootstrap loader program is set up on the hardware deadstart panel switches. When the 
deadstart button of the operator's console is activated, the bootstrap program is transferred to and executed 
in PPO. The bootstrap loader reads the PPO save program (CEA) from the first record on the deadstart file, 
executes it, then reads the deadstart control program (CED) from the next record into PPO and sets it into 
operation. CED determines the type of deadstart to be performed, then loads the required routines into all 
PPs involved in the deadstart process. The routines include a display routine in PPO and I/O routines in 
PP1 and PP2. CMR is read from the deadstart file into CM, and a display shows all deadstart functions 
and the options that may be selected. 

The functions include: 

Type of deadstart to be performed 

Level of system to be used 

Level of processing to be performed on rotating mass storage (RMS) device labels 

Status of permanent files to be used 

Restriction of permanent files to disk pack devices (854 and 841 only) 

Changes to be made to equipment configuration of the system 

Level of initialization of ECS 

Pre-allocation of RMS devices for customer engineering diagnostic programs 

The operator may select specific options or take the default option for each function. 

When processing of deadstart options is completed, control is passed to MTR and DSD. The system 
deadstart tape will be rewound to its load point, and it will not be referenced again during operation unless 
another deadstart is necessary. The tape may be removed and the tape unit cleared for use in other 
operations. At this point the system is ready to process jobs (see section 7). 
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DEADSTART - PHASE 1 
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DEADSTART - SYSTEM ACTIVATION 



Pre-Loader 



CED 



System Loader 



Deadstart Tape 



^_ 



// D jj CMR || EST IRP |l P \\ STL WlRCP 



PP1 



Deadstart Special Records 



"V" 




IRP 

I/O 

Routines 


\ 


PPO 


1 




CM 


\ 


CED 

Display 
Routines 




CMR 


PP2 


> 




RMS 
Control 
Routine 


/ 


Mass 
Storage 
Drivers 










IRCP 







60306500 A 



1-5 



Upon completion of system loading, the computer contains the following: 

1 . Initial system libraries, stored on one or more mass storage devices. Programs can be loaded from any 
system library into PPs or CM as needed. 

2. The central memory resident (CMR), loaded into the low end of central memory. A set of tables in 
CMR contain information about the system. Some of the tables are used by the system PP programs to 
communicate with each other. A record block table (RBT) is built in the upper end of CM. 

3. Also, some programs in the system are stored in central memory in an area immediately above the 
CMR. Such programs can be loaded into PPs or into other CM areas much faster than they can be 
loaded from the system storage device. Storage space in CM is costly and space used to store library 
programs cannot be used to run user programs; therefore, only the most necessary and frequently used 
library programs are stored there. For the same reason, CMR is kept as small as possible. 

4. The system monitor program (PPMTR in PPO and CPMTR in CMR) remains in overall control of the 
system. It controls allocation of system physical resources (CM, ECS, channels, equipments, PPs and 
CPUs). It handles all communications between user programs and the system and coordinates activities 
of the other PPUs. 

5. PP1 contains the operator console display driver program, DSD. DSD provides a communication path 
between system and operator. Current system status is displayed by DSD on the two screens in the 
operator console. The operator can control system operation by typing commands on the console 
keyboard. 

6. Each remaining PP contains pointers to a PP communications area, an area in CMR used for communi- 
cations between each PP and MTR, and a PP resident program loaded into each PP. The resident is 
responsible for reading the input register and loading PP overlay programs into its PP as assigned, and 
for providing communication between the overlays and MTR. 
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SCOPE SYSTEM TAPE 

The released SCOPE 3.4 system (deadstart) tape consists of 21 +n records, each followed by an EOR, 
where n is the number of programs and overlays in the tape: 

NAME Description 

CEA PPO save program 

CED Deadstart control program 

TDR 7-track/9-track driver 

D Deadstart dump control program 

DMT Dump magnetic tape driver 

CMR Central memory resident (n copies) 

COM Deadstart option matrix generator 

EST Deadstart equipment reconfiguration program 

IRP Deadstart RMS driver control program 

5CP Deadstart 6603-1 driver 

5CQ Deadstart 6638 driver 

5CT Deadstart 6603-11 driver 

5CR Deadstart 865 driver 

5CS Deadstart 854 driver 

5CU Deadstart 814 driver 

5CV Deadstart 821 driver 

5CW Deadstart 841 driver 

P Pre-address 6603-11 program 

STL Deadstart system initiation program (PP resident) 

IRCP Deadstart main program 

MTR System monitor program 
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DSD Display control program 

! Library name table 
PP name table 
PP programs 
Entry point table 
External reference list 
System ] External reference table 

Libraries 1 Program number table 

Program name table 
CP/PP routines 
Any installation may expand the above records in two ways: 

1. By installing CE Diagnostics. The deadstart diagnostic sequencer, CES, will be placed after CEA, 
followed by diagnostic routines selected for the site (CU1, ALS, FST, etc.), followed by routine CED. 

2. By placing up to seven additional CMR records on the system tape for different equipment 
configuration. 
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CENTRAL PROCESSOR AND SCOPE 



CM ORGANIZATION 

The allocation of central memory is illustrated below: 



Machine FL 



RBT 



Assigned to 
Control Points 



CM Library 



CMR 



High Core 



Low Core 



Low core is allocated to the central memory resident portion of SCOPE, executable system programs, and 
INTERCOM buffers. The length of the INTERCOM buffers area varies dynamically when INTERCOM is 
running. High core is allocated to the record block table (RBT); its length varies dynamically with the load 
of the system. The remaining area can be assigned to control points. 

CONTROL POINT CONCEPT 

Blocks of central memory storage not allocated for system use are ordered by control point number and 
assigned to jobs. Each control point number has a corresponding table in CMR called the control point 
area. A control point is not a physical entity, but rather a concept used to facilitate bookeeping. The control 
point number and the control point area, however, are physical quantities that do appear in the system. 

Under SCOPE 3.4, any number of control points up to 15 are possible. In the released system, the default 
value of N.CP is 1 5 decimal. In an installation with n control points for user jobs they are numbered from 
1 to n. A job assigned to a control point is identified by its control point number; only one job can be 
assigned to a control point at any one time. Once a job is assigned to a control point, system resources such 
as central memory, ECS, channels, equipments and processors may be assigned to the control point for use 
by the job. 

Storage assigned to a single control point is contiguous; storage for all control points is not necessarily 
contiguous. The core storage block assigned to the job at control point 2 is higher than the block for the job 
at control point 1, and storage for control point 3 is always higher than that for control point 2, and so on. 
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In the following figure, no storage is assigned to control points 3 and 5; unassigned storage appears 
between assigned storage. 



Machine FL 
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CM Library 



CMR 



High Core 



Low Core 



In addition to the n control points used for running jobs, two pseudo control points, numbered zero and 
n + 1, are used by the system. 

Control point zero is used to identify system resources not allocated to a job at a control point; they are 
unallocated or allocated to the system. If an equipment is assigned to a control point, that number is 
entered into the system table entry for that equipment. 

If not assigned to a job, the equipment is assigned to control point zero and is available to be assigned to a 
job. All active system files are attached to control point zero. They include the system file, any job files that 
have been read in and are waiting for scheduling, and all output files waiting to be processed by JANUS. 
Control point n+ 1 is used by monitor (MTR) when it runs a central processor (CP) system program. For 
example, if MTR needs to move the storage assigned to a control point, it asks CPMTR to initiate the CP 
storage move program in central memory resident. Since the CP storage move program is not associated 
with any specific job running at a control point, it is assigned to control point n + 1 . There is no control 
point area in CMR for control point n+ 1. 
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JOB DESCRIPTION NUMBER 

During the course of execution, a job might not remain continuously at the same control point. It is possible 
for the job to be swapped out while it is only partially executed. When a job is swapped out it is not 
associated with a control point. When a job is swapped back in it is probably associated with a control 
point other than the control point during its original assignment. 

During the time a job is swapped out, the only table in CMR that contains information about the job is the 
Job Descriptor Table (JDT). When a job is initialized at a control point it is also assigned to an entry in the 
JDT. The job descriptor number is constant and is used to identify the job during its entire execution. 

In order to clarify the difference between job descriptor number and control point number, JDT numbers 
start at n+ 1 where n is the number of control points. 

STORAGE MOVES 

Since jobs come and go as they finish processing and new jobs begin, or as jobs are swapped in and out, 
CM storage must be reallocated and jobs must be moved. If a job at a control point requests additional 
storage, it may be necessary to move jobs to obtain the required storage. MTR keeps a tally of unassigned 
CM in a CMR word T.UAS. Storage associated with each control point is of two types, either of which may 
have a zero value. 

Allocated storage is defined by the reference address (RA) and field length (FL) of the control 
point. 

Unallocated storage (UAS) lies between the allocated portions of two consecutive control points. 
This area is associated with the lower of the two control points, but it may be transferred to 
neighboring control points by moving any intervening allocated storage. 

A request for a reduced field length merely transfers storage to UAS (no storage moved). A request for an 
increased field length, when the total already associated with the control point is adequate, will result in a 
transfer of unallocated storage to allocated; no storage move will take place. 

If it is necessary to take unallocated storage from other control points to satisfy a request for increased field 
length, control points above and below the requesting control point will be a scanned. This scan locates the 
combination of unallocated storage blocks which will result in a move of the least amount of storage. 

In the diagram shown under Control Point Concept, if control point 1 needs more storage, it will be 
necessary to move control point 2. If control point 6 needs storage, sufficient unallocated storage may be 
available to make a control point move unnecessary. If, however, control point 7 needs additional storage, 
control points 4, 6 and 7 will be moved downward to provide the storage. Added storage always extends the 
field length upward. 
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STORAGE MOVE EXAMPLE: 

Control point 5 requests an FL of 300 (all values are increments of 100 octal). 



Before 



After 



Control 
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Storage (UAS) 
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If MTR takes the UAS from control point 7, the 1 50 units of central memory at control point 6 would have 
to be moved; however, taking UAS from 3 and 4 requires moving 120 units of central memory at control 
point 4 and 5. (20 units are moved from 4 to 3 and 100 units are moved from 5 and added on behind the 
20 units moved to 3.) 

CP - SYSTEM COMMUNICATION 

A running CP program must communicate with the system as illustrated in the following examples: 

1 . When a CP program is loaded and executed as a result of a control card call, the system must place any 
parameters specified on the control card in an area where they can be read by the CP program. 

2. No CP instructions allow a CP program to perform input/output; therefore a CP must send a request to 
the system, to load a PP program to execute the input/output. 

3. When a CP program terminates, it must advise the system that it may process the next control card. 

Since a CP program cannot access memory locations outside its field length, any area reserved for commu- 
nication between a CP program and the system must be within the field length of the job. The first 100 
(octal) locations of each job's field length are reserved for this purpose. The first program loaded into a user 
field length is always loaded at location RA+ 100 (for the user, this is location 100). 



24 
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RA COMMUNICATION AREA 



59 



35 29 23 17 



11 5 



RA+0 



RA+1 



RA+2 



O 



SS 



SL 



User/System Interface 



RA+53 



RA+54 



RA+63 



RA+64 



RA+65 



RA+66 



RA+67 



RA+70 



Parameter 
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Code 



1AJ Bootstrap for Absolute Programs 



Name/Library Name 
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Number of 
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FWA of Loadable 
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Memory Cataloge 
Table Pointer 



Control Statement Card Image 
(Replaced by Operator Message if O Bit Set and CFO Type-in) 



RA+77 



Run 2.3 ASA Flag +0 = Non-ASA; -0 = ASA 
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The first word of a user field length (location RA + 0) is reserved for use of hardware and software flags in 
event of error. Other locations in the first hundred words of a user field length store information needed for 
execution of system program. Monitor regularly scans location RA+1 which is presumed to contain a 
request from the central processor for monitor to summon a peripheral program. The form of the request 
is: 

59 41 39 n 



I I I II MM I I II I I I I I 

PP Program Name 


1 1 1 1 1 1 1 1 1 1 1 ii 1 1 1 1 1 1 1 1 1 1 1 m 1 1 1 1 nil ii ii 

r Address of Parameters 



r Recall Bit 40 

Loader information is placed by the first of several loader routines in words RA + 64 through RA + 67. 
This information is used and modified as additional loader routines complete specific tasks. 

When parameters are encountered on a control card, they are placed in locations RA + 2 through RA + 63 
by 1AJ, which stores the total number of parameters in location RA + 64. When the routine or file indicated 
on the control card executes, it finds in these locations the information needed to direct execution. 

CP - PP COMMUNICATION 

If a user's program places a call for a PP program in RA + 1 , CPMTR will pick up the RA + 1 call, insert 
the control point number of the caller into bits 36 through 39 of the word, and clear bit 41. If the central 
exchange jump (CEJ) installation is available, the user's program should use it immediately after placing a 
call in RA + 1 . This will cause CPMTR to begin execution immediately. If CPMTR determines that the 
RA + 1 call should be assigned to a PP it will pass the call on to MTR. 

When a PP is available, MTR will write the word into its PP input register, in CMR. Figure 3-2 shows 
the format of a PP input register for a transient program called from a CP program. The name, the auto- 
recall bit, and any parameters in bits zero through 35 appear in the input register exactly as they did in 
RA+ 1. Parameters are passed from a CP program to a PP program through this parameter field. 

For example, if the PP program CIO is called, CIO will find the relative address of the file environment 
table (FET) to be used in the operation by reading its input register. It can find the RA of the control point 
field length by reading the control point number from its input register, computing the address of the 
control point area, and reading the value of RA from the control point area. By adding the RA to the 
relative FET address, CIO obtains the absolute address of the start of the FET. CIO then reads the 
parameters for the I/O operation from the FET. 

MTR continually scans RA+ 1, in the event that the users program does not use the central exchange jump, 
or the instruction is not available. When a RA + 1 call is found MTR initiates CPMTR. Less CPU time is 
used by letting CPMTR process the call, than if MTR did it directly. 

Bit 59 of RA + 66 is used to communicate to the user program if the central exchange jump is available. If 
the hardware for this instruction is available the bit is set on. 
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PROGRAM RECALL 

The recall program status is provided in SCOPE to enable efficient use of the central processor and to 
capitalize on the multiprogramming capability of SCOPE. Often, a CP program must wait for an I/O 
operation to be completed before more computation can be performed. To eliminate the CPU time wasted 
if the CP program were placed in a loop to await I/O completion, a CP program can ask SCOPE to put the 
control point into recall status until a later time; and the CPU may be assigned to execute a program at 
some other control point. The job itself may be rolled out or swapped out, as necessary. 

Recall may be automatic or periodic. Auto-recall should be used when a program requests I/O or other 
system action and cannot proceed until the request is completed. SCOPE will not return control until the 
specific request has been satisfied. Periodic recall can be used when the program is waiting for any one of 
several requests to be completed. The program will be activated periodically, so that it can determine which 
request has been satisfied and whether or not it can proceed. 

PERIODIC RECALL 

To enter periodic recall, a CP program puts the characters RCL left-justified into RA+ 1. On encountering 
the RCL request, the system assigns the CPU to some other control point. After a certain interval of time 
has elapsed, the delay count of the control point in periodic recall will be reduced by the Advance Control 
Point (ACP) routine of PP monitor. When the count is zero, the PP is restarted and the CPU is again 
assigned to execute the program at the control point. At this time, the CP program can check completion bit 
in the FET to see if the I/O is finished. If so, the CP program may proceed with computations. If I/O is not 
complete, the CP program will put itself back into recall. 

AUTOMATIC RECALL 

If a CP program makes a request in RA+ 1 and bit 40 of RA+ 1 is set to one, the control point will be put 
into automatic recall after the request has been initiated. Again, the CPU is assigned to another control 
point as in periodic recall. In this case, however, the program in recall will be restarted by MTR after the 
completion bit in the FET has been set. MTR, not the user, checks the completion bit in the FET. 

Recall and auto-recall are most often used while waiting for CIO to process an I/O request; however, any 
time a PP program is called from RA+ 1, with bit 40 of RA+ 1 set to one, the control point will be put into 
auto-recall. If bit 40 is set, bits zero through 17 of RA+ 1 must contain the address of a word in the 
program's field length called a reply word. When the PP has completed its function, it will set the comple- 
tion bit (low order bit) in the reply word. When the completion bit is set, MTR will restart the program. 

For a call to CIO, the reply word is the first word of an FET. For other programs the reply word need not 
be part of an FET. 

Some PP programs (DMP and MSG) set the completion bit only when they are called with auto-recall. 
Periodic recall cannot be used for these programs. 

A CP program can put itself into auto-recall without calling a PP program by putting RCL left justified in 
RA+ 1 and setting bit 40 of RA+ 1 to one. Bits zero through 17 of RA+ 1 must contain the address of a 
reply word. A program which has already initiated one or more I/O operations might go into auto-recall in 
this way, using the first word of the FET associated with one of the I/O operations as the reply word. 
Figure 2-1 shows the formats of RA+ 1 for: a normal CIO call; a request for periodic recall; a CIO call 
with auto-recall bit set; and an RCL call with auto-recall bit set. For periodic recall, a user must issue a 
normal CIO call followed by an RCL request. For auto-recall, only one request is required. 



60306500 A 2-7 



Normally, CP programs use auto-recall for convenience, but only one request involving auto-recall can be 
processed at one time. For example, to initiate I/O action on several files at once, a user must employ the 
periodic recall technique. He will issue all the requests without recall (using a separate FET for each 
request); then go into periodic recall. Each time the CP program is restarted by the system, it can check all 
the files for completion and go back into periodic recall if any are still incomplete. 

Periodic recall may be used also when a CP program can initiate an I/O request and then perform some 
computation. In some cases, the I/O would be completed before the computation; in others, the computa- 
tion would be done first. The user would go into recall only when computation was done, and then only if 
the I/O was still in process. 

Periodic recall should also be used, if possible, to continue processing while only part of the data buffer has 
been read or written by the I/O driver. Some of the I/O drivers coordinate with MTR so that a program in 
periodic recall is restarted after one or two PRU's have been processed. 



CIO CALL 



59 



42 40 



17 



CI 



Count for 
Positioning Requests 



FET Address 



DISPLAY CODE (CIO = 031 1 17g) 

CIO CALL WITH AUTO-RECALL 
59 42 40 17 



CI O 



Count for 
Positioning Requests 



FET Address 



REQUEST FOR PERIODIC RECALL 



59 



42 



RCL 



59 



REQUEST FOR AUTO-RECALL 
42 40 17 



RCL 



Pseudo 
FET Address 



Figure 2-1 . Call Formats 
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CENTRAL MEMORY RESIDENT 

The low end of core storage is reserved for the central memory resident portion of SCOPE and the system 
library portions which reside in central memory. CMR contains pointers, tables and programs. Its length is 
dependent upon several factors, including the number of peripheral processors and the number of control 
points, which determine the number of tables in CMR and the length of certain tables. Some CMR tables 
are optional and may appear only by installation parameter. Figure 2-2 illustrates a typical CMR. 



Pointers and Small Tables 
(Lower Table Area) 



200 



Control Point Area and System Exchange Packages 



PP Communications Area 



Large Tables 
(Upper Table Area) 



CM Resident Programs 



ECS Tables 



Library Directory 



Figure 2-2. Typical CMR Assignments 
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SUMMARY OF CENTRAL MEMORY RESIDENT AREAS 

Lower Table Area Contains pointers to larger tables in the upper table area of CMR, along with various 
flags, constants, and installation option parameters. It includes accounting information, calendar and Julian 
dates, the system display label and other small tables. The lower table area occupies the first 200 words of 
central memory. 

Control Point Area Contains a 200-word area for each control point in the system. Each area contains the 
job name, exchange package, and other information related to the job running at that control point. The 
system exchange package is also contained in the same area. 

PP Communications Area Contains eight words for each peripheral processor in the system, through 
which they communicate with the system monitor and with each other. Each area contains the PP input 
and output registers and a 6-word message buffer. 

Upper Table Area Contains major tables pertinent to system and job operation. 

ECS Tables Area Contains buffers for transferring PP overlays and RMS files. 

CM Resident Program Area Contains eight resident programs: CP Monitor; CM Storage Move program; 
ECS Read/Write and Storage Move programs; memory manager; Integrated Scheduler; CP Circular I/O 
controller; and Stack Processor Manager. 

Library Directory Contains tables related to the system libraries, including library name table, PP pro- 
gram name table and the CM resident library programs. 
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59 



47 



CMR POINTER AREA 
35 23 



11 



P.ZERO 



P.LIB 

P.RBR 
P.RBT 

P.NPP 
P.NCP 
P.DFB 

P.SEQ 
P.FNT 
P.HEC 

P.CST 

P.PCOM 

P.EST 

P.PFM1 



P.PFM2 
P.INS 
P.EIRPR 
P.ELBST 

P.RQS 

P.DPT 

P.TAPES 

P.RMS 

P.STG 
P. I NT 
P.PFM3 



Zeros 


a 


C.DIRFWA 

FWA of Library 
Directory 




LWA+1 
Library Directory 


C.DSFLAG 
Deadstart 
Load Flag 




C.RBRAD 
FWAof RBR Area 


RBT Ordinal 
of Empty Chain 


Length/ 100B of 
RBT Area 


C.CMLWA 

(LWA+1 )/100B of 

CM 


FWA/8 of 
Dayfile Buffer 


(Reserved for 
250 Graphics Package) 


C.NPP 
No. of PPs 


C.NCP 
No. of CPs 


FWAof 
FNT 


LWA+1 of 
FNT 


C.SEQ 
T.SEQ/8 


C.SEQL 
L.SEQ 


C.HEC 

Hardware 

Error Count 


FWAof 
EST 


LWA+1 of 
EST 


C.CST 
FWA of CST 


C.CSTL 

LWA+1 of 

CST 


C.PCOM 

Address of 

Comm Area PP1 


C.SDTL 
N.SD 


C.APFL 
N.EAPF 


C.PFACT 

Activity 

Count 


C.APF 
T.APF 


C.PFMCH 
Toggle Byte 


C.SDL 
C.ESD 


C.MDL 
N.MD 


C.MD1 


C.MD2 


C.MD3 


i i 


(Reserved for Installations) 




ICC Register Address 


ICC Area Address 


Max. Length/1000B 

of ECS 

Library File 


ECS Flaw Table Address 


ECS Page Stack Address 


T.DAT 


L.DAT 


C.RQSFS 

FWA/2 of 

Request Stack 




No. of 

DST 

Entries 


FWA/8 of 
DST 


T.TAPES/8 


L.TAPES 


C.RMS 
T.RMS/8 


C.RMSL 
L.RMS 


T.DPT/8 




C.STG 
T.STG 


C.INT/C.IFL 

Control Point 

FL 


C.ITABL 




C.IBUFF 


C.ILTABL 


C.RBTC1 


C.RBTC2 


C.RBTC3 


C.RBTCL 
N.RBTC 


C.PFFNT 
FWAof 
PF FNTs 









10 



11 



12 



13 



14 



15 



16 



17 
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CMR POINTER AREA DETAILS 

These descriptions begin with the location number and the symbol. Contents of the words may change in 
released version of system. 

P.ZERO 

Contains a full word of binary zeros; a PP may clear five bytes at a time by reading this location. 
Also used as a program stop by CMR and idle program. Changing the contents of this word will 
usually destroy system operation. 

1 P.LIB 

Right justified in bytes and 1 is the first word address of the library directory; bytes 2 and 3 
contain the right-justified last word address plus one of the library directory. Byte 4 is a deadstart 
load flag. A library change flag appears in bit 59. 

2 P.RBT/P.RBR 

Bytes and 1 contain the right-justified first word address of the record block reservation area. 
Byte 2 contains the record block table word-pair ordinal of the first member of the RBT empty 
chain. Byte 3 contains the current length of the RBT area in 100-word blocks. Byte 4 contains the 
current size of central memory in 100-word blocks. 

3 P.DFB/P.NPP/P.NCP 

Byte contains the FWA/10 of the dayfile buffer area; bytes 1 and 2 are reserved for the 250 
graphics package. Bytes 3 and 4 contain the number of PP's and control points in the system, 
respectively. 

4 P.FNT/P.SEQ/P.HEC 

Bytes and 1 contain the FWA and LWA + 1 addresses of the file name table. Bytes 2 and 3 
contain the FWA and length of the diagnostic sequencer table. Byte 4 contains the hardware error 
count. 

5 P.EST/P.CST/P.PCOM 

Bytes and 1 contain the FWA and LWA+ 1 addresses of the equipment status table. Bytes 2 and 
3 contain the FWA and LWA + 1 addresses of the channel status table. Byte 4 contains the FWA 
of the communications area for PP 1 . 

6 P.PFM1 

The number of permanent file sub-directories, number of empty attached permanent file table entries, 
permanent file activity count, FWA of attached permanent file table, and the permanent file toggle byte are 
in bytes to 4, respectively. 
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Bits in the toggle byte are: 

RBTC wrap around 

1 Attached permanent file interlock 

2 Permanent file directory interlock 

3 RBTC interlock 

4 Utility interlock 

5 Master directory interlock 

6 TRANSPF lockout. 

7 P.PFM2 

The number of entries per sub-directory is in byte 0. The length of and pointers to master directory 
entries are in bytes 1 to 4. 

10 P.INS 

Reserved for installation use. 

1 1 P.EIRPR 

Contains the ICC register address and ICC area address. 

12 P.ELBST 

Contains the ECS flaw table and page stack processor address. Byte contains the maximum size 
of the ECS library file in 1000-word pages. 

13 P.RQS 

Bytes and 1 contain the FWA and length, respectively, of the device activity table. Byte 2 
contains FWA/2 of the request stack. Right justified in byte 3 is the current number of device 
status entries. FWA of the device status table is in byte 4. 

14 P.TAPES/P.RMS/P.DPT 

Bytes and 1 contain the FWA/ 10 and length of the tape configuration table. Bytes 2 and 3 
contain the FWA/ 10 and length of the RMS preallocation table. Byte 4 contains the FWA/ 10 of 
the device pool table. 

15 P.STG 

The FWA of the tape staging table is in byte 4. The rest of the word is currently unused. 

16 P.INT 

Byte contains the control point zero field length value; byte 1 points to the INTERCOM table; 
bytes 2, 3 and 4 point to the INTERCOM reserved core and buffer. 

17 P.PFM3 

Bytes 0, 1 and 2 contain pointers to the RBTC. Byte 3 contains the number of RBTC entries; byte 4 
points to the FWA of the FNT's for the permanent file system. 
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CMR POINTER AREA 



T.JDATE 



P.CMFL 



T.CPJOBN 
P.PJT 

T.EPBL 
P.ECSFL 

T.CLK 

T.SLAB1 
T.DATE 

T.SLAB2 



T.SLAB6 



T.MSP 





59 


M 


35 


23 


11 




(Leading Zeros) Y Y D D D 




7777 8 




CPU A Idle Time in Seconds 


in Milliseconds 






CPU B Idle Time in Seconds 


in Milliseconds 




(Reserved for PP Idle Time) 






Storage 
Move Flag 




Machine 
FL/100B 




ASYSTEMAAA 




Job Sequence 
Number 




Job Count 


C.PJTFWA 
T.PJT/8 


C.PJTLWA 
T.PJT/8+L.PJT/8 


) 


C.ECSPL 
ECS Page Length 


C.ECSBL 
ECS Buffer Length 


C.CPECFL 
Control Point 
ECS FL/1000B 




H H . M M S S 


} 


MM/ DD/YY 






System Label 

SCOPE 

Version 

3.4 
































Debugger 


Step Flag 



20 



21 



22 



23 



24 



25 



26 



27 



30 



31 



32 



33 



34 



35 



36 



37 
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20 T.JDATE 

The current Julian day number is stored here in the form yyddd with leading zeros. 

21 (W.CPATIM) 

Byte contains all ones; bytes 2, 3 and 4 contain CPU-A accumulated idle time at control point 
zero. 

22 (W.CPBTIM) 

Bytes 2, 3, and 4 contain CPU-B accumulated idle time at control point zero. 

23 (W.PPTIME) 

Contains accumulated PP time for control point zero. 

24 P.CMFL 

Contains in byte 4 the current machine core size in 100-word blocks and in byte 2 the control point 
zero storage move flag. 

25 (W.CPJNAM) 

Contains control point zero job name in the form SYSTEM 

26 T.CPJOBN/P.PJT 

Bytes and 2 contain the job sequence number and job count, respectively. FWA and LWA of the 
parameter storage area for delayed PP job is in bytes 3 and 4. 

27 P.EPBL/P.ECSFL 

Right-justified in bytes and 1 is the ECS page length as set by IP.EPAG; right-justified in bytes 2 
and 3 is the ECS buffer length set by IP.EBUF. Byte 4 contains the current number of ECS pages 
assigned to control point zero. 



60306500 A 2-15 



CMR LOWER TABLE AREA DETAILS 

Each description begins with the location and symbol. 

30 T.CLK 

Current display clock time in the format: 
hh.mm.ss. 

31 T.DATE/T.SLAB1 

Current calendar date is in the format: 

mm/dd/yy 

This is the first of a 6-word system display label. 

32 (IP.SYSL1)T.SLAB2 

33 T.SLAB3 

These two words provide storage for up to 20 characters for the system display label first line, as 
given by installation parameter. 

34 (IP.VER) T.SLAB4 
System version identification. 

35 (IP.SYSE) T.SLAB5 
System edition date. 

36 T.SLAB6 
Unused. 

37 T.MSP 

Monitor step flag in byte 4, a debug flag is in byte 3. 
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CMR POINTER AREA 



59 



47 



35 



23 



11 



T.MSC 



P.CHRQ 



P.PPLIB 



P.VRNBUF 



T.CPSTA 



T.CPSTB 



T.MXNCTL 



T.PPID 



T.PPIP 



T.PPSO 



T.SPF 



T.RCHN 

T.CPT1 
T.UAS 



T.ECSPAR 



Count of PP 

Job Queue 

Entries 



Number of 
IdlePPs 



Number of Seconds/4096 



Position of CIO 



C.VRNFWA 
T.VRNBUF/8 







C.VRNFIN 
Pointer to 
First VRN 



Idle Exchange Package 



Number of 
Programs 



C.STGFLG 

Stage 
ON/OFF 



End of Slice Time 



Q Q Q 



C.CHRQ 

First 10 

Channels 



C.CHRQ2 

Second 10 

Channels 



Address of 
First Entry 



C.VRNINT 

Buffer 

Interlock 



C.VRNFUL 

Buffer Full 

Flag 



2 Exchange Package Address 



3 



2 Exchange Package Address 2 




CP-MTR Requests 



PP-MTR Requests 



PP Input 
Register Address 



PP Input 
Register Address 



(Reserved) 



MTR Scratch Word 



Control 
Point Number 



EST Ordinal 



(Reserved) 



SPM-1RN Communications Word 



Unassigned 
CM/100B 



Unassigned 
ECS/1000B 



ECS Size 



ECS Flaw 
Table Flag 



First RBT 
Word Pair 
to Release 



Initial CMTR 
P Address 



ECS Parity 
Flag 



ECS Parity 
Address/1 000B 



40 



41 



42 



43 



47 



50 



51 



52 



53 



54 



55 



56 



57 



Job 
Mode 



Monitor Mode 
OFF 

Not in 

Monitor 

Mode 



-In Monitor 
Mode 
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40 T.MSC 

Real time clock (microsecond count) in bytes 2 through 4. Count of jobs in PP job queue in byte 0; 
a count of idle PPs is in byte 1 . 

41 P.CHRQ 

Active channel request queue flags for the first 10 channels in byte 3; for the second 10 channels in 
byte 4. 

42 P.PPLIB 

Byte contains the current position of CIO; the number of programs in the system library is given 
in byte 2. The address of the first library table entry is right-justified in bytes 3 and 4. 

43 P.VRNBUF 

Contains volume serial (visual reel) number buffer information and tape staging flags. 

44 T.CPSTA 

45 T.CPSTB (one word for each CPU) 



Value while the CPU is running in job mode: 
59 41 



23 17 



Idle Exchange Pack 


End of Slice time 


2 


Exchange Package 
Address 



Value while the CPU is running in monitor mode: 
59 



23 



* * * * * * i * * i * * * * 3 ' 3'* * * * 



Value while the CPU is turned off: 
59 
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46 T.MXNCTL 

Value while not in monitor mode: 



59 








47 








35 




29 




11 









Q 


Q 


Q 


Q 





7 





4 


2 





Exchange Package 
Address 


2 


6 


1 


X 



Value while in monitor mode: 

59 47 35 



**** 0304************ 



This word contains PP executable code. It is used to perform the MXN for any PP monitor 
function. 

QQQQ i s the complement of the lowest control point job queue priority for which an MXN may 
be performed. This is used only by time critical jobs. The usual value is 7777 (-0) for MXN systems 
or 0000 for EXN systems. 

X = or 1. The CPU number of the CPU that is running the lower priority job. CMTR sets this 
and the exchange package address at which the job is running. 

47 T.PPID 

Contains PP input register address and current monitor request made by CP. 

50 T.PPIP 

Contains PP input register and current monitor request made by PP. 

5 1 Currently reserved 

52 T.PPS0 

Used as a scratch word by MTR. 

53 T.SPF 

Contains the number of the control points currently using CP in byte 0; its EST ordinal is in 
byte 4. 

54 Currently reserved. 
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55 T.RCHN 

First RBT word pointer of the chain to be released in byte 4. The rest of the word contains the 
SPM-1RN communications word. 

56 T.UAS/T.CPT1 

Byte contains the number of unassigned CM 100-word storage blocks; byte 1 contains the 
number of unassigned ECS 1000-word blocks. Byte 2 contains the current size of ECS. Bytes 3 and 
4 contain, right-justified, the initial program address of the CM monitor. 

57 T.ECSPAR 

Bytes and 1 are unused. Byte 2 contains ECS flaw table full flag; byte 3 contains ECS parity flag; 
byte 4 contains ECS block address in which parity error occurred. 



2 - 20 60306500 A 





59 


CMR POINTER AREA 

47 35 23 1 


1 


P.SCH 


C.SRSL 

C.LEJDT 

LE.JDT 


C.SRS 
T.XPSCH/10B 


C.JCA 
T.SCHJCA/10B 


C.LJDT 
L.SCHJDT 


C.JDT 
T.SCHJDT/10B 


P.STR 


C.NFL 
Needed 
FL/100B 


C.JQP 

Queue Priority of 

Job in Counter 


C.RFL 
Reserved 
FL/100B 


C.STMF 
SCH Recall 


C.AFL 
Available 
FL/100B 


T.SCHCP 


Interlock Word (Scheduler) 


T.SCHPP 


Interlock Word (PP Routines) 


P.RPT 


T.RPT/10B 


L.RPT 




P.MAIL ) 
P.SWPECS) 
P.SCHPT ) 


C.MAILF 
T.MAI L/1 OB 


C.MAILL 
L.MAIL 


C.SWPECS 
L.ECSSWP 


C.SCHPT 
T.SCHPT/10B 






(Reserved) 




(Reserved) 




(Reserved) 




(Reserved) 




(Reserved) 




(Reserved) 




(Reserved) 




(Reserved) 




(Reserved) 




(Reserved for DDP Simulator) 



60 



61 



62 



63 



64 



65 



66 



67 



70 



71 



72 



73 



74 



75 



76 



77 
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60 P.SCH 

Contains information relative to the integrated scheduler. Pointer to job scheduler exchange pack- 
age is in byte 1; a pointer to the job control area is in byte 2; length and pointer to the job 
description table is in bytes 3 and 4; length of job description table entries is in byte 0. 

61 P.STR 

Information relative to job scheduling. 

62 P.SCHCP 

Interlock word for integrated scheduler. 

63 P.SCHPP 

Interlock word for PP routines. 

64 P.RPT 

Pointer to and length of removable pack table in bytes and 1 , respectively. 

65 P.MAIL/P.SWPECS/P.SCHPT 

Pointer to and length of scheduler mail box buffer in bytes and 1, respectively. The ECS swap 
flags are in byte 2. Pointer to the job scheduler is in byte 3. The ECS swap flag values are: 

00 Swap only INTERCOM job on quantum to ECS. 

X 1 Swap INTERCOM jobs to ECS at end of job. 

IX Swap batch jobs to ECS at end of quantum or when waiting for 

CM field length assignment. 

66-76 Reserved for future use. 

77 Reserved for use by DDP Simulator. 

100 T.CST 

Entries for the channel status table. 
154 T.PPSn 

One word entries containing status information for up to 20 PPs. 
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CONTROL POINT AREA 



59 



47 44 41 



35 



29 



23 



17 14 11 



i 



W.CPSLIC 
W.CPLINK 

W.CPTIME 

W.CPTIMB 

W.PPTIME 
W.CPPTM 

W.CPSTAT 

W.CPFL 

W.CPEF 

W.CPJNAM 

W.CPCC 

W.CPECS 

W.CPDFM 

W.CPPRI 
W.CPJCP 
W.CPTIML 

W.CPSWP 
W.CPINT 

W.CPSCH 
W.CPRO 

W.SSW 
W.CPSSW . 



Exchange Package 



^ 



C.CPSTAT 
Status Byte 



C.CPSLIC 

Total CPU Time 

Slice Allotted 



C.CPUQS 
CPU-A 



C.CPUQMS 
Seconds/4096 
This Quantum 



C.CPUQS C.CPUQMS 

CPU-B Seconds/4096 
This Quantum 



C.CPPQS C.CPPQMS 

PP Seconds/4096 

This Quantum 



C.CPEF 
Error Flag 



C.CPLINK 
Previous Active 
Control Point 



Next Active 
Control Point 



C.CPUAS 
Total CPU-A Time as Number of Seconds/4096 



C.CPUBS 
Total CPU-B Time as Number of Seconds/4096 



C.CPPTS 
Total PP Time as Number of Seconds/4096 



C.CPSM 
Storage Move 



C.CPRA 
RA/100B 



C.CPJNAM 



Job Name 



C.CPRPV 

Reprieve 

CKSM Value 



C.CPRPA 



Reprieve Address 



C.CPNFL 
Nominal 
FL/100 8 



C.CPECRA 
ECS RA/1000B 



C.CPFL 
FL/100B 



JDT 
Ordinal 



C.CPNCSP 
Next Control 
Card Pointer 



C.CPECFL 
ECS FL/1000B 



Last Dayfile Message 



C.CPTIML 
Current Time 
Limit (15 Bits) 



C.CPTLI 

Initial Time 
Limit (15 Bits) 



C.CPQNT 

Quantum 



C.CPFLG 
Swap Flags 



C.CPJQP 

Job Queue 

Priority 



CCPRPRI 
Job Class 



C.CPECSI 
Initial ECS 
FL/1000B 



C.CPUTA 



User Table 
Address 



C.CPRFL 
Reserved FL 



C.CPFLI 

Initial 

FL/100B 



C.CPORG 
C.CPEVNT job 
Flags | Origin 



C.CPJDA 

JDT Address 

(Absolute) 



C.CPSSW 

Sense 
Switches 



(Reserved) 



(Reserved) 



(Reserved) 



(Reserved) 



17 
20 

21 

22 

23 

24 

25 

26 

27 
30 

37 
40 

41 

42 

43 

44 

45 

46 

47 
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59 



CONTROL POINT AREA 

47 42 35 23 



17 



11 



W.CPFACT 

W.CPFST 

W.CKP 
W.CPCKP 

W.CPOAE 
W.CPVRNO 

W.CPLDR1 

W.CPLDR2 
W.CPLS 

W.CPLDR3 

W.CPAR 

W.CPSTG 



W.CPDFMC 

W.CPDPV 

W.CPIRB 

W.CPFP 

W.CPOUT 

W.CPFLAG 

W.CPERT . 

W.CPMSLM 



W.CHTIM 
W.CPMSI 

W.CPSR 

W.CPCAF 
W.CPCAL 



Account Parameter for Permanent Files 



FST Entry for Next Control Card PRU 



C.CPREQ 
Req Flag 



I 



Relative Address 
of Tape Label Info 



C.CPCON 

Console 

Checkpoint Flag 



C.CPCKP 

Number of 

Checkpoints 



C.CPOAE 

Equipment 

Assigned 



1 = Extended Label Format 

Family Pack VI D Assignment 



C.CPLW 

C.CPLT 

Loader Flags 



Global Library 



Set 



Indicators 



RA+1 Contents (and Control Point Number) 
of Last Auto-recall Request 



C.CPAR 



C.CPTMT 
MT 



C.CPDFMC 

Dayfile 
Msg Count 



C.CPFLAG 
Flags 



C.CPTNT 
NT 



Reply Word Address 



C.CPRERN 
Rerun Priority — 



C.CPRBID 

INTERCOM Batch 

Routing ID 



C.CPFST 
FST Address 



C.CPMSLM 

MS Limit inPRU's 



C.CPSITM 

Time of Swap-In 



C.CPSR 



C.CPMNT 
MT I NT 
Max Max 



C.CPDPV 
Job Dep. ID 



C.CPFP 

C.CPOUT 

Flags 



C.CPMSRC 

Running PRU Count 



Channel Time as Number of Seconds/4096 



C.CPESR 
(Non-zero During 
ECS-Disc Transfer) 



Control Card Buffer 



f 



Reserved for Installations 



50 
51 
52 
53 
54 
55 
56 
57 

60 

61 

62 

63 

64 

65 

66 

67 
70 



167 
170 



j?„ 
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CONTROL POINT AREA CHART NOTES 
MNEMONIC WORD 



W.CPLINK 
W.CPSLIC 



20 



W.CPSWP 



41 



W.CPSCH 



BIT 

C.CPSTAT Status bits 

M Move flag move in progress) 

1 Y Auto recall 

2 A CPU-A assigned only 

3 B CPU-B assigned only 

4 X Recall status 

5 W Wait status 

6 R Real-time job (currently not used) 

7 C Active - CPUA 

8 D Active - CPUB 

9 S Activity suspended by job swapper. 
1 P Activity suspended by checkpoint 



C.CPORG values (octal) 



4 

10 

20 

40 

100 



Real time 

Graphics 

Multi-user 

INTERCOM 

Event flag for swap-out 



42 



C.CPFLG bits 



W.CPLDR1 



55 




1 

2 
3 
4 
5 
6 
7 
8 
9 
10 
11 



unused 

unused 

unused 

S.CP1IB 

S.CPFFL 

S.CPEOJ 

S.CPCLR 

S.CPRFL 

S.CPROP 

S.CPSIP 

S.CPSOP 

S.CPSWC 



C.CPLW bits 



1IB operating at control point 
FNTs in positive FL 
end of job 

control point area clear request 
storage request in progress 
rollout in progress 
swapin in progress 
swapout in progress 
swapout complete 



11-10 W Indicator for loader to be used 

9-6 M Map Options 

5 R Reduce flag 

4 S.CPLT Debugging aid flag 

3-2 L Library Set indicator 

1 S.CPLP Program loaded from non-sys- 
tem library 

(Reserved) 
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W.CPFLAG 



63 



C.CPFLAG bits 



(S.CPLDAF) MDI interlock 

1 Rerun priority present 

2 Private pack overflow 

3- 1 2 (S.CPNTNT) If on, do not search FNT) 

4-12 (Reserved) 



W.CPFP 



63 



C.CPFP bits 



S.CPL Reprocess 

1 S.CPG Abort 

2 S.CPA No rerun 

3 S.CPS Sequencer 

4 S.CPN Checkpoint taken 

5 S.CPX EXIT card encountered 

6 S.CPDP Private disk pack 

7 S.CPEOR Control card EOR unused 

8 S.CPJFL Job card field length assigned 

9 S.CPJ JANUS 

10 S.CPR Remote batch 

1 1 S.CPE INTERCOM 



W.CPEF 



24 



C.CPEF 



CONTROL POINT AREA ERROR FLAG VALUES 



1 
2 
3 
4 
5 
6 
7 
10 
11 

12 
13 
14 
15 
16 
17 
61 
62 



F.ERTL 

F.ERAR 

F.ERPP 

F.ERCP 

F.ERPCE 

F.EROD 

F.ERK 

F.ERRN 

F.EREX 

F.ERCC 

F.ERECP 

F.ERJC 

F.ERPA 

F.ERRCL 

F.ERHANG 

F.ERMSL 

F.ERPARF 

F.ERPAR 



CP time limit, sensed by MTR 

CP arithmetic error, sensed by MTR 

PP abort (MABORT), requested by PP 

CP abort (ABT in RA + 1 ), requested by program 

PP-call error; abort, sensed by MTR 

Operator drop type-in 

Kill, operator type-in 

Rerun, operator type-in 

Control card error, set by 1AJ 

Control card error for INTERCOM job 

ECS parity error, sensed by MTR 

Job card error 

Pre-abort job before coming to control point 

Auto recall error, bad PP call 

Job hung in auto recall 

Mass storage limit exceeded by stack processor 

Parity error sensed by Scheduler 

Parity error sensed by Scheduler 
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PP COMMUNICATIONS AREAS 



Symbol 

T.PPC1 

T.PPC2 

T.PPC3 

T.PPC4 
T.PPC5 
T.PPC6 

T.PPC7 

T.PPC8 

T.PPC9 



Function Description 



Nine 8-word areas are set aside for communications 
with PP units 1 through 9. 



T.CPIR 
T.CPOR 



Control point n + 1 input register 
Control point n + 1 output register 



The last two words are used for communication between MTR and CP programs; this area is the MTR 
communications region. 



RELATIVE WORD DESCRIPTIONS IN PP COMMUNICATIONS AREA (T.PPCn) 

W.PPIR PP input register 

1 W.PPOR PP output register (scanned by MTR) 



2-6 



W.PPMESn 



Six-word message buffer used to pass parameters 
between CP and PP programs. 
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PP COMMUNICATION AREA 



FOR PPO 





59 




7 







W.PPIR 


CPCIO Output Register 


W.PPOR 


MTR Output Register 


W.PPMES1 




W.PPMES2 




W.PPMES3 


7HDAYFILE 


000030 


W.PPMES4 





W.PPMES5 


7HCERFILE 


0000 30 


W.PPMES6 














Extend for 
System Dayfile 



Extend for 
CERFILE 



FOR PP1 



W.PPIR 

W.PPOR 
W.PPMES1 
W.PPMES2 
W.PPMES3 
W.PPMES4 
W.PPMES5 
W.PPMES6 



DSD Input Register 



DSD Output Register 



Stack Request Parameters 



Control Point 
■ Message Buffer 



DSD - 1DL Communication Word 



Figure 2-3. PP Communications Areas 
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59 



W.PPIR 



W.PPOR 



W.PPMES1 



W.PPMES2 



W.PPMES3 



W.PPMES4 



W.PPMES5 



W.PPMES6 



FOR PP2 THROUGH PPn 

39 35 



I C.CPNUM 
Program Name or 



t^ 



Control Point No. 
• Recall 
•Called from event or delay stack 



/STACK REQUEST PARAMETERS/ 



COMMUNICATION WORD 



EVENT STACK PARAMETERS 



59 



47 



COMMUNICATION WORD 
35 23 



17 



11 



C.RWPPCF 


C.RWPPWT 


C.RWPPLW 


C.RWPPCC I C.RWPPWC 


Control 


Cumulative 


PP Buffer 


C.RWPPST | Current PRU Byte 


Point 


Byte Count 


Length 


| Code and Status Count 



Figure 2-3. PP Communications Areas (continued) 
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CENTRAL MEMORY RESIDENT 






Pointers 


100 


Channel Status Table 


154 


PP Status Words 


200 


T.CPA n 


Control Point Areas 




T.XPIDLA 


System Exchange Packages 




T.PPC n 


PP Communication Areas 


* 


T.EST 


Equipment Status Table 


♦ 


T.FNT 


File Name Table 


* 


T.ITABL 


INTERCOM Table 


# 


T.DAT 


Device Activity Table 


# 


T.STG 


Tape Staging Table 


* 


T.APF 


Attached Permanent File Table 


* 


T.RQS 


Request Stack 




T.RBR 


Record Block Reservation Table (Headers) 




T.RBRBIT 


RBR Bit Table 




T.DST 


Device Status Table 




T.DPT 


Device Pool Table 




T.SEQ 


Sequencer Table 




T.RMS 


Rotating Mass Storage Diagnostic Table 




T.INS 


Installation Area 




T.VSNBUF 


VSN Buffer 




T.TAPES 


Tapes Table 




T.RPT 


Removable Pack Table 




T.MAIL 


Scheduler Mailbox Buffer 




T.DFB 


Dayfile Buffers 




T.PJT 


Parameter Storage for Delayed PP Jobs 




T.SCHPT 


(Optional) Scheduler Statistics 




T.SCHJCA 


Scheduler Job Control Area 




T.SCHJDT 


Scheduler Job Descriptor Table 




T.SUBPG 


Subpage Buffer 




T.ECTL 


ECS Buffer for RMS- ECS Transfer 




T.EPAGE 


Empty Page Stack 




CM Resident Programs 




T.LIB 


Library Directory 




INTERCOM Pointer Area 




INTERCOM Small Buffers and User Tables 




INTERCOM Large Buffers 



Begin Before 10000g 



*Table Must 

*Table Must Begin Before 20000 Q 
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SUMMARY OF TABLES IN UPPER TABLE AREA 

Equipment Status Table One entry for each device in the system configuration. Non-allocatable devices 
can be assigned to one control point at a time; allocatable devices may be attached to many control points 
simultaneously. 

File Name Table Contains an entry for each file in the system, created when the file is created. Several 
entries are preset and remain in the system for duration; these entries are for the system library (deadstart) 
file, the system and control point dayfiles, and the hardware error file. 

INTERCOM Table Provides multiplexer and port definition information for INTERCOM program use. 
Assembled only by installation parameter IP.INTCM. 

Device Activity Table One-word entry for each RMS device in system. Each entry provides dynamic 
information related to current activity of the RMS device. 

Attached Permanent File Table Provides information for the permanent file manager and job use. Con- 
trol and status information entries are created when a permanent file is cataloged initially or attached to a 
qualified CP program. 

Request Stack Requests for data transfers, device positioning, or logical file operations. Each allocatable 
device in system may have one or more 3-word entry in this table when a request for its use is pending. 

Record Block Reservation Table Provides continuous information as to assignment/availability of record 
blocks in which file data is recorded on allocatable devices. Strings of bits in the RBRBIT table denote 
current status of record blocks in each device. 

Device Status Table Directly related to the request stack; contains a 2-word entry for each allocatable 
device in the system, plus an additional pseudo-entry for unassigned file processing. 

Device Pool Table Contains a 10-word area for each RMS device. Used by ISP and 1EP to pass their 
internal pool area to each other. 

Sequencer Table Contains 30-word entry for each preallocated RMS device for use for CE diagnostic 
programs. 

RMS Diagnostic Table Reflects areas on the system rotating mass storage device preallocated during 
deadstart to customer engineering diagnostic programs. 

Installation Table Reserved for specific needs of installation. Tables are generated in the area only by 
installation. 

Nova Table Created only by installation parameter for support of 250 Interactive Graphics devices. 

Tape Staging Table Defines availability, assignment, and demand for tape devices. 

Dayfile Buffer Area Contains dayfile buffers and file environment table entries of the system dayfile, the 
control point dayfiles, and the hardware error file. The control point zero buffer is at the end of this area. 
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Peripheral Job Table Contains parameters saved for delayed PP jobs. 

Mailbox Used for communications between CP monitor and scheduler. 

Scheduler Performance Table Optional table used to collect execution data to study the efficiency of the 
integrated scheduler. Created by installation parameter IP.SPT set to 1. 

Job Control Area Contains entries pertinent to the scheduling of jobs by class and queue priorities. 

Job Descriptor Table Contains linked entries for each class of job. Entries describe job requirements, 
current status, accumulated use time of system components, etc. See Job Processing, Chapter 7. 

Move Buffer Used for handling ECS/RMS storage moves and partitioning. 

Library Directory Falls at the end of the CMR upper table area following the CM resident programs and 
ECS tables; and is of variable length. It contains 2-word entries in the program name table section and 
1-word entries in the entry point table. The directory length may expand or contract as programs are added 
and deleted or as program residence is changed. 

CP Resident Programs 

Symbol Name/Function 

CP.MTR Central processor monitor 

CP.SM Central memory storage move 

CP.ECSM ECS storage move (assembled by installation option parameter IP.MECS) 

CP.SPM Stack processor manager 

CP.SCH Memory manager 

CP.SCH 1 Integrated scheduler 

CP.ECOVL ECS read/write PP overlay 

CP.CIO Central Processor I/O controller 
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PERIPHERAL PROCESSORS AND SCOPE 



PERIPHERAL PROCESSOR ORGANIZATION 

When SCOPE 3.4 is loaded into the computer at deadstart time, system monitor, MTR, and the system 
display program, DSD, are loaded into peripheral processors and 1, respectively, where they reside 
permanently. All peripheral processors in the system contain a group of permanently assigned storage 
locations called the PP direct cells; each PP contains a copy of the PP resident program which handles 
common service functions for the PP programs that may be loaded into the unassigned pool processors. 

PP programs are loaded into a pool processor by the PP resident and remain in a PP only until they have 
completed a specific function. When loaded, the program may load additional overlays to help complete its 
function; on completion, the program may be overlaid by another transient program loaded by PP resident 
to perform another, often unrelated, function. Figure (3-1) shows a typical layout of a pool PP loaded with 
a transient PP program and an overlay. The PP direct cells occupy locations to 77; the PP resident is 
loaded starting at location 103 to approximately 777. The remainder of the PP is occupied by PP transient 
programs, except for PPO and PP 1 which contain MTR and DSD, respectively. 
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Specific assignment of the PP direct cells is detailed in the following chart. 



Direct Cells 



Pointer to input register 



Pointer to message buffer 



Control point address 



Pointer to PP status word 



Field access flag 



Channel time (seconds) 



Channel time (milliseconds) 



PP Resident 



Transient Programs 



Secondary Overlays 



^ 



74 


D.PPIR 


75 


D.PPMES1 


76 


D.CPAD 


77 


D.PPSTAT 


100 




101 




102 




103 





773 



1773 



J 7777 



Figure 3-1 . Pool PP Layout 



* Cells 76-102 constitute the five bytes of the PP status word in central memory. 
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PP DIRECT CELL ASSIGNMENT 
Octal Identifier 



Function 





1 

2 

3 

4 

5 

6 

7 

10 

11 

12 

13 

14 

15 

16 

17 

20 



32 



37 



40 

45 
46 
47 
50 

55 

56 

57 
60 

62 

64 




Temporary 
storage 



output register buffer 



D.EST/D.JPAR 
D.TH2 

D.DTS/D.JFL 
D.TH7 



D.BA/D.FR0 

D.JECS/D.FR5 
D.JPR/D.FR6 
D.JTL/DFR7 
D.PPIRB/D.FF0 

D.RA/D.FF5 

D.FL/D.FF6 

D.FA/D.FF7 
D.FIRST/D.SX0 

D.IN/D.SX2 

D.OUT/D.SX4 



/ 

D.FNT through D.FNT + 9 contain words 2 and 
3 of the FNT, referred to as the file status table 
(FST). 

D.EST through D.EST+4 contain the EST entry 
in process. D.JPAR contains a job parity flag. 

D.DTS contains device type code in left 6 bits 

and allocation type code in right 6 bits; D.JFL 

contains CM field length requirement returned to 

caller by 2TJ. 

Contains first word of FET in D.BA through 

D.BA + 4 (buffer address). 

ECS field length returned by 2TJ to caller. 

Computed job priority returned to caller by 2TJ. 

Job time limit returned to caller by 2TJ. 

D.PPIRB through D.PPIRB + 4 contain PP input 

register contents. 

Reference address divided by 100 (octal) control 

point to which PP is attached. 

CM field length divided by 100 (octal) for job at 

control point to which PP is attached. 

Address of second word of FNT entry in process. 

This and next cell contain 18-bit CM address of 

word FIRST in circular I/O buffer. 

This and next cell contain 18-bit CM address of 

word IN in circular I/O buffer. 

This and next cell contain 18-bit CM address 

word OUT in circular I/O buffer. 
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Octal 



Identifier 



Function 



66 

70 

71 

72 

73 

74 

75 

76 

77 

100 

101 

102 



D.LIMIT/D.SX6 

D.PPONE/D.SV0 

D.HN/D.SV1 

D.TH/D.SV2 

D.TR/D.SV3 

D.PPIR/D.SV4 

D.PPMES1 

D.CPAD 

D.PPSTAT 



This and next cell contain 1 8-bit address of word 

LIMIT in circular I/O buffer. 

Preset to constant value plus one ( + 1 ). 

Preset to constant value + 100 (octal). 

Preset to constant value + 1000 (octal). 

Preset to constant value +3. 

PP input register address. 

Address of first word of PP message buffer. 

Address of control point area in use by PP. 

Pointer to PP status word. 

Field access flag. 

Channel time in seconds. 

Channel time in milliseconds. 



PP COMMUNICATIONS 

For each pool PP, CMR has an area used for communication between the PP monitor and the PP. Each 
area contains a PP input register and a PP output register, each one CM-word long, plus a six CM-word 
message buffer. In section 2, Figure 2-3 is a diagram of a PP communications area. 

When a PP is idle, the input register in the communications area contains zero. When PPMTR assigns a PP 
to load and run a transient PP program, it will load a request word into the assigned PP input register. 
Figure 3-2 shows the format of a PP input register for a transient program called from a CP program. 
CPMTR will have inserted the requesting program's control point number into bit 36-39 of the word and 
cleared bit 41. Bits 0-35 appear in the input register exactly as they did in RA+ 1 of the requesting CP 
program. 



59 



41 39 



35 



Program Name 

In 
Display Code 



CP 

No. 



Parameters 



Figure 3-2. PP Input Register 
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The PP resident in each PP constantly scans its own input register. When it becomes non-zero, the PP 
resident will search the program name table in the library directory in CMR for the program name 
specified in the input register. It will load the transient program at location 773 and store the address of the 
control point area to which the PP is assigned in direct cell D.CPAD, then transfer control to location 1000 
to start execution. If the transient needs to load an overlay, it calls a subroutine in the PP resident. PP 
resident loads the overlay. Since the input register is not cleared until the PP becomes idle, parameters 
transmitted by PPMTR in the input register can be read by the transient program and/or any overlay. 
When the PP transient program has completed its function, it sends a request to PPMTR to drop the PP. 
PPMTR will clear the PP input register and record the fact that the PP is idle and that another program 
can be loaded into the PP. The transient program terminates by executing a jump to the idle loop of the PP 
resident which scans the input register for the next assigned task. 

When PP resident has a monitor request, it places a message into the PP output register in the PP commu- 
nication area. The leftmost byte contains a number which identifies the function requested; other bytes may 
contain parameters for the request. Additional information or parameters for the request may be placed in 
the message buffer in the PP communications area. After making the request, PP resident waits for the first 
byte of the output register to be set to zero, signalling that the monitor has processed the request. If 
CPMTR or PPMTR need to communicate with the PP about the request being processed, it will store the 
necessary information in the remaining bytes of the output register. 

PP RESIDENT 

The PP resident program performs two main functions: 

Handles all communication between MTR and the transient and/or overlay program 

Loads transient programs and overlays and initiates execution of these programs 

The PP resident is made up of a series of routines, each of which performs a specific function. (See figure 
3-3.) These resident routines are used by the transient and overlay programs as required. The routines, their 
names, locations, calling sequences and functions are described below. 



60306500 A 3.5 



Field Access Flags 



PP Resident Idle Loop 



Load Primary PP Overlay 



Load PP Overlay 



Transmit Data To/From Stack Processor 



Special Words Used by Loader 



Access Request Stack Entry 



Request Access to Control Point Field Length 



Terminate Access to Control Point Field Length 



Compare Accumulator to Field Length 



Process Monitor Function 



Wait for Output Register to Clear 



Reserve Channel 



Drop Channel 



Mask a Byte into Specified Words 



Transmit Dayfile Message 



R.FAF 
R.IDLE 
R.OVLJ 
R.OVL 

R.READP 
R.WRITEP 



R.RWP 
R.RWPP 



R.EREQS 



R.RAFL 
R.PAUSE 



R.TAFL 

R.TFL 

R.MTR 
R.PROCES 

R.WAIT 

R.RCH 

R.DCH 



R.STBMSK 
R.STB 



R.DFM 



Figure 3-3. PP Resident Routines 
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(103) R.IDLE PP Resident Idle Loop 

Calling sequence: LJM R.IDLE 

In the idle loop, PP resident continually scans its input register for an assigned task. R.IDLE destroys direct 
cells 20 through 22 and some of the temporary storage cells; R.OVLJ and all other PP resident routines 
destroy only the temporary cells through 17. 

(135) R.OVLJ Primary (transient program) Overlay Loader 

Calling sequence: Store name of overlay left-justified in D.T6, D.T7 

LJM R.OVLJ 

When this routine is called, the resident loads a new primary overlay at C.PPFWA minus L.PPHDR and 
transfers control to location C.PPFWA. 

(144) R.OVL Overlay Loader 

Calling sequence: Load A register with load point address 

RJM R.OVL 

A search for the secondary overlay whose name is left justified in D.T6 and D.T7 will be made in the PP 
program name table (PPNT). If found, it will be loaded into the PP beginning at the address given in the A 
register. R.OVL is used by both PP resident and PP overlays to load the named overlay. To load disk 
resident overlays, PP resident does not reference the disk directly, it makes a call to the stack processor by 
calling R.READP. If the overlay is not located, an OVLERR error message is produced and the control 
point is aborted. 

(316) R.READP Transmit Data Via Channel from Stack Processor 

(325) R.WRITEP Transmit Data Via Channel to Stack Processor 

Calling Sequence: Load L(request) 

RJM R.READP (R.WRITEP) 

Computes PP word count from first and last word addresses given in the request formatted at the request 
location and adds the computed word count, the address of the PP message buffer, and the control point 
number to the request. The request is entered in the stack, and data is transmitted via channel directly to/ 
from PP memory. Upon exit from R.READP (R.WRITEP), the following information is set: 

(D.T3 + C.RWPPLW) LWA + 1 of data transmitted 

(D.T3 + C.RWPPST) Upper 6 bits of status 

(D.T3 + C.RWPPWT) Number of PP words transmitted 

(D.T4 + C.RWPPST) Lower 1 2 bits of status 
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(342) R.RWP Special entry point to R.READP used by LDR. 

(356) R.RWPP Word in R. READP modfied by LDR. 

(431) R.EREQS Enter Stack Request 

Calling Sequence: Store L(request) in D.TO 

RJM R.EREQS 

This routine adds the control point number to the already formatted request and searches the central 
memory request stack for an empty entry. The monitor function, M.EREQS, is called, and PP resident 
iterates until MTR accepts the request. If the available flag is set (S.STF + S.STFA of byte C.STFB of the 
second word of the request), R.EREQS exits to R.IDLE. Otherwise, it returns control to its caller. 

(464) R.RAFL Request Control Point Field Length Access 

Calling Sequence: RJM R.RAFL 

The storage move flag for the control point is tested. If set, a call is made to R.TAFL; when clear, the field 
access flag in the PP status word is set, the RA in D.RA is reset, and the FL in D.FL is reset. 

(R.PAUSE is the same as R.RAFL.) 

(517) R.TAFL Terminate Control Point Field Length Access 

Calling Sequence: RJM R.TAFL 

This routine is called to clear the field access flags in the PP byte R.FAF and in the PP status word. 

(533) R.TFL Test Field Length 

Calling Sequence: Load relative address 

RJM R.TFL 

This routine ensures that a relative address is within the field length limits. The 18-bit address is added to 
the control point reference address and compared with the field length. If the resultant address is out of 
range, R.TFL exits with a negative A register; otherwise, the A register will contain the resultant absolute 
CM address (RA + relative address) upon exit. The RA and FL values are found locally in the PP resident, 
at R.CPRA and R.CPFL, respectively. These locations are initialized when a new transient program is 
loaded into the PP; the transient and its overlays cannot call R.TFL until R.RAFL has been called. 
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(544) R.MTR Process Monitor Function 

(R.PROCES is identical with R.MTR) 

Calling Sequence: Store function parameters in D.T1 to D.T4 

Load function code 
RJM R.MTR 

Places the function code in D.TO, writes D.TO through D.T4 to the output register, and waits for the output 
register to clear via a call to R.WAIT. 

(555) R.WAIT PP Wait Loop 

Calling Sequence: RJM R.WAIT 

Determines if the monitor function is for MTR or CPMTR. If the MXN instruction is not available, 
R.WAIT is modified at deadstart causing R.WAIT to assume that all functions are for MTR. If the function 
is for CPMTR, the PP input register address is written into T.PPID and T.MXNCTL is read in and 
executed. If the function is for MTR the input register address is written in T.PPIP. 

After either action, R.WAIT idles until byte zero of the output register is cleared. 

(617) R.RCH Request Channel 

Calling Sequence: Load channel numbers 

RJM R.RCH 

Channel numbers loaded in the A register will be stored in D.T1, the monitor function M.RCH inserted 
into D.T4, and then D.TO through D.T4 will be written to the output register for that PP. Channel numbers 
in D.T1 and D.T2 will be assigned by monitor on the following priority basis: 



D.TO 


D.T1 


D.T2 


D.T3 


D.T4 




(2) I (1) 


(4) j (3) 







The highest priority is given to the channel number in the rightmost 6 bits of D.T1; the second highest to 
the channel number in the leftmost 6 bits of D.T1, etc. 

When assigning alternate channels, monitor will discontinue its search of D.T1 and D.T2 when it encoun- 
ters 6 zero bits. If only one alternate channel is wanted, the programmer must clear D.T2 before calling 
R.RCH. As an example, the coding for requesting primary channel 12 alternate channel 13 would be: 



LDN 





STD 


D.T2 


LDC 


1312B 


RJM 


R.RRCH 



Normally, MTR will stop looking for alternate channels after four have been investigated; in the above 
example, only two channels will be investigated. 
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When R.RCH is called, the function is not considered complete until byte of the output register is cleared, 
which signals that a channel has been assigned. 

If an M.RCH channel request is made directly to R.MTR, additional action is taken. If MTR cannot assign 
a channel, it moves byte 4 of the output register to byte and signals the requesting PP in byte 4 of the 
output register to wait unitl the channel is assigned. 

(627) R.DCH Drop Channel 

Calling Sequence: Load channel number 

RJM R.DCH 

The specified channel will be dropped. Since more than one PP can request the same channel at the same 
time, a MTR request must be used to reserve a channel. Only the PP reserving the channel can release it by 
making a R.DCH call; the function will modify the CST entry for the channel to indicate that it is free. 

(641) R.STBMSK 

Address in PP resident of a logical mask used by R.STB routine. This mask is initially 7700 octal; the value 
should be restored by any routine which substitutes an alternate mask. 

(650) R.STB Store Byte 

Calling Sequence: Load L(List) 

RJM R.STB 

List has the form: 

L(BYTE) 

L(WORDl) 

L(WORD2) 



L(WORDn) 
ZERO 

A logical AND is performed on the mask at location R.STBMSK for each word in the list before the word 
is exclusive-ORed with word BYTE. R.STB is used primarily to substitute channel numbers in driver 
overlays. 



(656) R.DFM Enter Dayfile Message 

Calling Sequence: Load L(message) + flag bits 

LOAD R.DFM 
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A message is written to the dayfile and/or displayed on console. The flag bits in the high-order 6 bits of the 
A register are used to determine message destinations. In the flag bit values given below, one or more bits 
may be on; all are optional. 

Bit 1 Dayfile A display only 

Bit 2 Control point (system) message 

Bit 4 Dayfile (no A display) 

Bit 12 A $ is inserted in 20th character of message sent to system dayfile 

(installation use only.) 

PP PROGRAM NAME RESERVATIONS (3.4) 

8AA thru 8A9 Reserved 

8BA thru 8B9 Reserved 

8CA thru 8C9 Customer Engineering 

8DA thru 8D9 DSD 

8EA thru 8E9 DSD (7000 overlays) 

8FA thru 8F9 Reserved 



8WA thru 8W9 Reserved 

8XA thru 8X9 DSD 

8YA thru 8Y9 Reserved 

8ZA thru 8Z9 INTERCOM 

9AA thru 9A9 Customer Engineering 



9YA thru 9Y9 Customer Engineering 

9ZA thru 9Z9 INTERCOM 

All PP overlay names (OV.xxx symbols) are listed in Appendix B. 

SCOPE SYSTEM MONITOR 

In SCOPE 3.4, there are two separate monitors: CPMTR (CP.MTR) which controls CPU monitor mode 
execution and CPU scheduling, and the PPMTR (OV.MTR) which is in general control of the system and 
operates in PPO. 

DEFINITION OF MONITOR TERMINOLOGY 
MODES 

The CPU executes in either Monitor Mode or User Mode. The state is determined by a Monitor Mode flag 
which is either set or clear, respectively. The effect of the flag and the CPU mode determines the behavior 
of exchange jumps. 
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In Monitor Mode, the CPU is permitted to execute without interruption until a task has been completed. In 
SCOPE 3.4, this mode is used by CPMTR. SPM (Stack Processor Manager) and CPCIO to process ECS I/O 
transfers. Monitor Mode is terminated by an exchange jump to a program in user mode. 

All programs, including system programs (with the exception of CPMTR, SPM and CPCIO) run in User 
Mode which can be interrupted at any time, if the CPU is needed by a Monitor Mode program. Use of the 
CPU is time-sliced for each User Mode program. If it has not relinquished the use of the CPU within the 
span of the time slice, the User Mode program is interrupted at the expiration of the time slice. 

Separate exchange package areas are reserved for each user mode program, including IDLE. While the 
CPU is in user mode, the CPMTR exchange package is stored in the exchange package area of the program 
that is in execution. Refer to the System Program Job Exchange Package Area, Figure 3-4, and Exchange 
Package, Figure 3-5. 



T.XPIDLA |~ 



W.CPUST/W.CPSLIC 

W.CPTIME 

W.CPTIMB 

W.PPTIME 

W.XPIR 

W.XPOR 

Scheduler Only 
T.SCHRS 

T.MTRRS 



Exchange Package 



CPU-A Idle Time 



CPU-B Idle Time 



PPU Idle Time 



Integrated Scheduler 
Request Stack Table 



L.SCHRS=4 



1" 



CPMTR MTR Request Stack 



L.MTRRS=4 
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Figure 3-4. System Job Exchange Package Areas 
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Figure 3-5. Exchange Package 
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EXCHANGE JUMPS 



An installation may make use of the optional hardware instructions MXN (Monitor Exchange) and XJ 
(Exchange Jump) or EXN (Exchange). SCOPE 3.4 requires either the combination of MXN/XJ or EXN. 



MXN 



This is a PP initiated exchange jump to place the CPU in monitor mode execution. This exchange jump is 
conditional upon the setting of the Monitor Mode flag, which represents the execution mode of the CPU If 
the flag is set, the CPU is in Monitor Mode and the MXN will be treated as a Pass instruction If the flag 
bit is clear, this instruction will set the flag and initiate the exchange of data in the system job exchange 
package area, placing the CPU into Monitor Mode. 



XJ 



The Exchange instruction is to be used in conjunction with MXN. The action of the XJ depends upon the 
mode of the CPU. When the CPU is in User Mode, the CPU executes in Monitor Mode upon completion 
of the exchange jump. The CPU executes in User Mode upon completion of an XJ issued in Monitor Mode 
The CMR Resident programs CP.SM (Storage Move) and CP.SCH1 (Integrated Scheduler) are system 
programs that run in User Mode and use the XJ when available in the system. 



EXN 



In an installation without the MXN/XJ instruction set, the EXN instruction is used. It is a PP initiated 
exchange jump which occurs independently of the mode of the CPU and has no effect of the CPU mode. 
MTR is the only PP program that may perform an EXN; it must simulate the MXN for all PPs in the 
system and simulate XJ for the central processor. When MTR detects a request for CPMTR in a PP output 
register, it will: 

EXN to the exchange package address given in the CPU status word T.CPSTA in order to initiate 
CPMTR. 

Loop on an RPN instruction until P = 0. (Since XJ does not exist, CPMTR will terminate on an 
jump to zero.) 

EXN to the exchange package address given in T.CPSTA and then restore the CPMTR address in 
the exchange package P register. If there is no job to run, T.CPSTA will point to the idle package. 
When there are two CPUs in the system, T.CPSTA is used for the first CPU and T.CPSTB is used 
for the second CPU. 
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EXCHANGE PACKAGE MANAGEMENT 

The transfer of control from one user mode program to another is controlled by CPMTR. CPMTR is 
initiated either by an XJ from the user mode program in execution or by an MXN to the exchange package 
whose address is in T.CPSTA (MTR) or T.MXNCTL (PP resident). 

The exchange leaves the exchange package of the user mode program in its own area, with CPMTR being 
executed. CPMTR modifies T.CPSTA and T.MXNCTL to prevent another MXN to the old exchange 
package address. It then selects which user mode job should be executed next, rewrites T.CPSTA and 
T.MXNCTL with the new exchange package address and executes an XJ to that exchange package area. 

A 6500 or 6700 has an IDLE exchange package area for each CPU. This permits both CPU's to execute the 
IDLE program simultaneously. 

EXCHANGE PACKAGE CONTROL WORD 

A word in the lower table area of CMR contains executable PP code used by PP resident to perform the 
Monitor Exchange Jump (MXN) for any CPMTR function. See description of T.MXNCTL in Section 2. 

CONTROL POINT STATUS 

The status of the control point is contained in byte C.CPSTAT of word W.CPUST in the control point area. 

11 10 98765432 10 





p 


s 


D 


C 


R 


W 


X 


B 


A 


Y 


M 



At any given time, the status of a control point can be determined by the combination of bits set. 



M 
X, Y 



A, B 



W 



Set by CPMTR to indicate that a storage move is in progress for this control point. 

Used to indicate the type of recall associated with a peripheral task request and are set 
to temporarily relinquish the CPU while the task is in progress. The X-bit indicates 
periodic recall and is set by the user through the use of RCL. The Y-bit is set by any 
RA+ 1 call in which the auto-recall bit is set. 

Used to indicate the CPU in which the control point may execute. Delegation to CPU 
A and CPU B are indicated by bits A and B, respectively. The job must be executed by 
the CPU to which it is delegated. 

The bit is generally set by an M.RCP function and remains set until an END or ABT 
is posted from RA+ 1 or until an M.DCP function is requested. 
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C, D Used to indicate the CPU in which the job is currently executing. CPU A and CPU B 

are indicated by bits C and D, respectively. 

P, S Used to indicate the suspension of execution of the control point by either the job 

swapper (S) or checkpoint dump (P). 

R Used to indicate a real-time job (currently used). 

All of the control points for which W is set (is assigned to a CPU) and P, S, X, and Y are clear (execution 
not suspended or in recall), are linked together into a circular chain. At the end of a CPU time-slice period, 
CPMTR will advance to the next job in the chain for which neither C, D, or M is set (not currently in 
execution or undergoing a storage move). 

CPU STATUS 

A control word for each CPU appears in the lower table area of CMR. Each can have a different value 
when the CPU is running in Monitor Mode, User Mode, or when the CPU is turned off. See Section 2 for 
words T.CPSTA and T.CPSTB and the description of their contents. 

CPMTR 

The CP monitor has several specific tasks: Control point status processing, RA+1 request processing, 
processing CP monitor requests from PPs, reservation and assignment of channels. 

STATUS PROCESSING 

When a CPU is required for a control point, the Wait (W) status bit is set in the control point status byte 
C.CPSTAT in the control point area. The control point is linked into the chain of control points requesting 
a CPU which is then processed by the CPU selection process. 

RA + 1 REQUEST PROCESSING 

CPMTR distinguishes between system and user CPU programs as follows: 

System programs run at control point N.CP+ 1 with an RA equal to zero, a field length of 377777, 
depending on CM size. These programs cannot make requests through RA+1; they are initiated by 
CPMTR and use an output register associated with their exchange package area. 

User programs run at control point 1 through N.CP and communicate with CPMTR via RA+1. CPMTR 
scans periodically the contents of RA+ 1 in each active program. If RA+ 1 is non-zero, CPMTR considers 
it to be a request and processes it before clearing RA + 1 . 

The first three characters in RA+ 1 determine the request type and action to be taken: 
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CIO CPMTR checks the request to see if it is a PP call or a call for 

CPCIO and processes it accordingly. 

END End of user program and set the control point to zero status. The 

CPU selection routine is then called. 

ABT Abort the program. Set the error flag to F.ERCP for the control 

point and set the control point to zero status. 

RCL Enter recall status: 

If the automatic recall bit (40) is not set, the control point is put 
in X status and periodic recall delay is initiated. 

If the automatic recall bit is set and the parameter address points 
to an incomplete status, the control point is put in Y status. 

If the automatic recall bit is set and the parameter address points 
to a complete status, the request is considered to be a no- 
operation. 

TIM Supply time or date to the user program, depending upon the 

value transmitted in RA+ 1. CPMTR returns the following infor- 
mation to the location specified in the parameter address: 

Elapsed CPU time (W.CPTIME/ 
W.CPTIMB) 

1 Current date (T.DATE) 

2 Clock time (T.CLK) 

3 Julian date (T.JDATE) 

4 Elapsed time since deadstart (T.MSC) 

If the characters in RA + 1 are other than the above value, they are considered to represent a PP program 
call if the first character is alphabetic. CPMTR takes the contents of RA+1, clears bits 36-39 and 41, 
inserts the control number, and then considers this entry to be a PP input register image, so it will place the 
entry into the Monitor Request Stack (T.MTRRS). 

If the automatic recall bit is set and the parameter address points to an incomplete status, the control point 
is put into X + Y status. Every time the general activity count of the control point is reduced, CPMTR 
checks the status and puts the control point into W status if the completion bit is set. When such a request 
is encountered, CPMTR records the status address by writing the complete request from RA + 1 to word 
W.CPAR in the control point area. If the automatic recall bit is set and the parameter address points to a 
status already complete, the control point is aborted. 

During CP request processing, CPMTR can set the following error flags: 

F.ERCP Control point aborted. Error flag is set in response to an ABT request. 
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F.ERPCE PP call error detected when a PP program call does not begin with an alphabetic character or 

when an invalid parameter is transmitted. 

F.ERRCL Automatic recall error detected when a PP program call is issued with the automatic 

recall bit set and the parameter address points to a complete status. 

CURRENT CPMTR FUNCTION CODES AND MNEMONICS 

01 M.SETST Set CP status bit 

02 M.CLRST Clear CP status bit 

03 M.RCP Request central processor 

04 M.DCP Drop central processor job 

05 M.RCLCP Recall central processor job 

06 M.ICE Initiate central executive 

07 M.CPUST Change CPU status (IP.MCPU * 1 ) 

10 M.SLICE MTR interrupt at end of job's CPU time slice 

1 1 not used 

12 M.RCH Reserve channel 

In the request format, those bits or bytes indicated by * have no significance to the function. 

M.SETST SET STATUS BITS 

(0001,BBBB,****,****,00NN) 

BBBB Pattern of bits to be set 

NN Control point number (only if in MTR output register) 

Called to set CP status bits in byte C.CPSTAT in control point NN area. May cause linkage to or delinkage 
from chain of control points actively waiting for a CPU. 

M.CLRST CLEAR STATUS 

(0002, BBBB,****, ****,00NN) 

BBBB Pattern of bits to be cleared 

NN Control point number (only is in MTR output register) 

Called to clear CP status bits in byte C.CPSTAT in control point linkage. Will cause linkage to or delinkage 
from chain of control points actively waiting for a CPU. 

M.RCP REQUEST CENTRAL PROCESSOR 

(0003 **** **** **** ****\ 

This request is ignored under the following conditions: 
Requesting PPU is assigned to control point zero 
Error flag is set for the control point 
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Job is already in the waiting status. 
If none of the above conditions exist. CPMTR sets the job in waiting status (W). 

M.DCP DROP CENTRAL PROCESSOR JOB 

(0004 **** **** **** ****\ 

Execution of the central processor job at control point is stopped. The control point status is set to zero 
status (Z; the W and X bits are clear), the secondary status, bits M, Y, A, and B are not altered. The control 
point status bits set prior to M.DCP are returned in byte 1 of the output register of the requesting PPU. 

M.RCLCP RECALL CENTRAL PROGRAM 

(0005 **** **** **** ****\ 

This request is effective only if the central program associated with the requesting PPU is in recall status, 
and no error flag is set at the control point. The status of the control point is set to waiting (W). In any 
other case, the status of the control point is not altered. 

M.ICE INITIATE CENTRAL EXECUTIVE 

(0006 **** **** **** 1 1 t t \ 

IIII identifies a central memory resident program which will be started by CPMTR upon recognition of this 
request. This system program will run at control point N.CP+ 1 with a priority of 7777 (RA = 0, FL = 
377777, ECS RA = 0, ECS FL = 10000000). It will terminate by setting the output register T.CPIR to 
zero; MTR loops and tests T.CPIR for non-zero. The M.ICE request is delayed if a system program is 
already active; CPMTR initiates only one system program at a time. 

IIII Program 

CM storage move 

1 ECS storage move 

2 Unused 

3 Stack Processor Manager 

4 Load PP program from ECS library 

5 Unused 

6 Unused 

7 Request ECS buffer 

10 Release ECS buffer 

1 1 Request system buffer 

12 Release system buffer 

13 RMS-ECS move 

14 ECS-RMS move 

15 Flush ECS buffer 
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M.CPUST CHANGE CPU STATUS 

(0007 ***x **** **** 00NN) 

( 1 ) N is non-zero 

The request is ignored if a CPU is OFF. Otherwise, the control point status is dedi- 
cated to CPU X (X = 1 or 2) and will be allowed to use this CPU for the duration of 
the job. 

(2) N = 0, X = 

If either CPU is off, it is returned to the ON status, unless it was locked off at deadstart 
load time. 

(3) N = 0, X = 1 or 2 

CPU X is turned off and dedication of any control point to this CPU is cancelled. 

(4) N^ 0, X = 

Control point N is released from dedicated status. 

M.SLICE TERMINATE TIME SLICE PERIOD 

fOOlf) **** **** **** * * * * \ 

Only the PPMTR can issue this function request. It is issued to interrupt an executing user mode program 
so that CPMTR can reschedule the use of CPUs. 

M.RCH REQUEST CHANNEL RESERVATION 

(0012,BBAA,DDCC,****,RRRR) 

AA 1st choice channel number 

BB 2nd choice channel number 

CC 3rd choice channel number 

DD 4th choice channel number 

RRRR = 0000 Request immediate reply 

RRRR = 0000 No reply until a requested channel has been reserved. 

When channel zero is requested, it must be field AA. Zero BB. CC. or DD implies no channel request and 
no alternate choices. If none of the requested channels is available and an immediate reply is requested. 
PPMTR will set bytes and 4 of the PPU output register to zero. When a channel is granted, the number 
of that channel will be returned in the PPU output register byte 1 (location of AA). Byte 4 will be set to a 
non-zero value. 

On exit, if a channel has been reserved, the output register appear: 

0000 XXXX TTTT TTTT YYYY 

XXXX Channel number 

TTTT TTTT Information from the channel status word. 

YYYY PP input register address 
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M.MTRCPU is the symbolic limit for CPMTR functions. Its current value is 12; therefore CPMTR will 
process only those functions whose values are from 1 to 12, inclusive. 

CPMTR/PPMTR COMMUNICATIONS 

When a user program posts an RA + 1 call, CPMTR picks it up and determines the processing procedure to 
be followed. When CPMTR determines that the call is for a PP program, it sets up the request in the next 
available entry in a 4-word circular buffer, T.MTRRS, known as the monitor request stack and used 
specifically for CP to PP monitor communications. Any PPMTR function request generated by CM system 
programs would also be placed in the buffer. The monitor request stack is located adjacent to the exchange 
package for CP resident programs. 

PPMTR 

The PP Monitor is in general control of the system. It is loaded into PPO at deadstart and remains there for 
the duration of system execution. Primarily, PPMTR controls and co-ordinates system activities to avoid 
conflicts between various system processors. It allocates peripheral processors, central memory and ECS to 
the control points; in addition, PPMTR maintains the system clock. 

MAIN LOOP 

As soon as PPMTR has been loaded into PPO and initialized, it begins execution of the main loop, 
consisting of several functions executed on each pass, plus a group of lesser functions, one of which is 
executed on each pass. The primary functions performed in the main loop are: 

Scan the 4-word monitor request stack (T.MTRRS) for a PPMTR function call or a PP program 
request. 

Scan the PP input register (T.PPIP) for a PPMTR function request. 

After completing the primary main loop functions, PPMTR will process a slower function taken from a list 
called DSTRING (dispersal string). Each entry in the list is not necessarily unique: for instance, the 
advance clock (AVC) routine must be entered once every four milliseconds, hence it will appear five times 
in the list. 

The DSTRING list contains the following functions: 

AVC Advance Clock 

ACP Advance Control Point 

PPX Scan PP Output Registers 

CHCIO Check CP.CIO Output Register 
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SYSP 


System Program Advancement 


PDS 


Process Delay Stack 


PEZ 


Test P-register for Zero 


CHR 


Channel Rejection History 


PPM 


Process Monitor Request 


Clock Routine (AVC) 





The function of this routine is to maintain the real time and display code clocks stored in the CMR pointer 
area at T.MSC and T.CLK, respectively. The real time clock specifies time in increments of 244 microsec- 
onds (one 4096th of a second); the other specifies time in hours, minutes and seconds in display code. The 
AVC routine must be entered every four milliseconds. It interrupts the CPU at the end of every time slice 
and accumulates idle PP time for use by the Scheduler. If the time limit set for the job has been exceeded, 
MTR will set the error flag F.ERTL and the control point is put in drop status. 

CPU time is accumulated by a hardware clock used by the computer to time hardware instructions and 
which is connected to channel 14 (octal). There is no entry for channel 14 in the channel status table 
because more than one PP can read the clock at the same time. Therefore, it is not necessary to have an 
interlock and to reserve the channel. 

Advance Control Point Routine (ACP) 

On each pass through the main loop, MTR will analyse the status and activity of one control point by 
checking for the following conditions: 

If the control point is in drop status and no activity remains, 1AJ is called to the control point to 
process the next control card. 

If the control point is in periodic recall (X status set in W.CPSTAT), MTR will decrement the 
recall delay count associated with the control point. When zero is reached, ACP recalls the control 
point and exits. 

If the control point is in auto-recall and there is no activity at the control point (Y status set in 
W.CPSTAT), the control point is hung in auto-recall since there is no way the completion bit can 
be set. MTR will set the error flag F.ERHANG and put the control point in drop status. 

If there is activity while in auto-recall, or there is a request in the PPMTR request stack, ACP 
attempts to restart the control point; ACP exits if there is no auto-recall and there is activity at the 
control point or an outstanding stack request exists. 

SCAN PP OUTPUT REGISTERS (PPX) 

In this routine, the PP output registers are scanned for a monitor request made by a PP. This is an indexed 
scan of active PPs which are linked through APLINK. When PPMTR assigns a PP to process a request, the 
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routine requested and the PP input register number are entered in the CMR word T.PPIP. This routine 
enables a request to be processed without its address being entered into T.PPIP. 

CHECK CP.CIO OUTPUT REGISTER (CHCIO) 

This routine checks the output register T.CPIR of CP.CIO. If a MTR request is present, PPMTR will have 
it processed. 

SYSTEM PROGRAM ADVANCEMENT (SYSP) 

This routine scans the event stack and if a request for the Scheduler has been made, it is initiated. 

P-REGISTER EQUALS ZERO TEST (PEZ) 

When location counter (P register) for a user program is zero, an arithmetic error has been detected and 
error flag F.ERAR is set by MTR. 

Process Delay Stack Routine (PDS) 

A PP job is put into the PP job queue when MTR cannot find an available PP into which the program can 
be loaded. Programs in the job queue are linked together in the same order as they were put into the queue; 
so that the first program in the chain has been in the job queue the longest. If a job is rolled out when its 
delay expires, it is re-entered into the delay stack with a new delay period assigned. 

When a PP program issues a request to load a PP program after a delay of a certain time period, PPMTR 
inserts an entry into the PP delay stack. On each pass through the main loop, PPMTR scans the queue of 
PP job requests issued with a time delay and initiates the PP jobs whose delay has expired. Physically, the 
PP delay stack, the event stack and the PP job queue are treated as one table. Entries in the delay stack are 
chained together in order of increasing delay time, and the chain is linked to the end of the PP job queue. 
When the delay time of an entry in the delay stack becomes zero, it is considered to be part of the PP job 
queue. 

CHANNEL REJECTION HISTORY (CHR) 

This routine is the last in the DSTRING list. It updates the record of rejected channels, initializes the 
channel request register and resets the dispersal index for the next pass through the DSTRING. 

PPMTR Function Request Processing (PPM) 

All PP requests are made by placing the request number (M.xxxx) in byte zero of the PP output register. 
Parameters for the various requests are supplied to MTR through bytes 1 to 4 of the output register and/or 
the PP message buffer. (See figure 3-6.) Upon completion of the request, MTR replies by setting byte zero 
of the PP output register to zero and passes the response to the requesting PP through the remaining bytes 
of the output register or through the message buffer. 

If the format of the request is incorrect, MTR sets the high-order bit of byte zero in the output register of 
the requesting PP. As MTR will ignore any PP request with this bit set, the requesting PPU is hung. The 
following message 

ppn NAMcp BAD MTR REQUEST 
is inserted into the MTR message buffer to be flashed at the bottom of the right screen. 
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Figure 3-6. Monitor Request Processing 
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PP MTR Function Codes and Mnemonics 



13 
14 
15 
16 

17 
20 
21 
22 
23 
24 
25 
26 
27 
30 
31 
32 
33 
34 
35 
36 
37 
40 
41 
42 
43 
44 
45 
46 
47 
77 
400 



M.DFM 

M.STEP 

M.RBTSTO 

M.RSTOR 

M.TSR 

M.DPP 

M.ABORT 

M.REQP 

M.DEQP 

M.SEQ 

M.SEF 

M.ISP 

M.SPRCL 

M.CCPA 

M.RPJ 

M.EES 

M.CPJ 

M.SCH 

M.PASS 

M.RACT 

M.RPP 

M.NTIME 

M.PPTIME 

M.PPCH 

M.BUFPTR 

M.PATCH 

M. TRACE 

M.SLPER 

M.KILL 

M.INPROC 



Dayfile message 

Not used 

Enter step mode 

Reduce RBT storage 

Request storage 

Terminate storage request (IP.RTMTR^ 0) 

Drop PP 

Abort control point and drop PP 

Request equipment 

Drop equipment 

Assign job sequence number 

Set error flag 

Initiate Stack Processor 

Stack Processor recall 

Change control point assignment 

Request peripheral job 

Enter event stack 

Capture peripheral job 

Initiate integrated scheduler 

MTR ignores it 

Request control point activity 

Request PP 

Enter new time limit 

Assign PP time 

CPMTR requests a channel 

Buffer pointer address 

Enter a patch into MTR 

Turn on MTR trace mode 

Set new time slice period 

A bad MTR request made 

PPMTR is processing a function 



The request formats are described below; function parameters are given for each request. Asterisks denote 
bits which are irrelevant to the function. Requests are listed alphabetically by SCPTEXT mnemonic. 



M.ABORT ABORT CONTROL POINT AND DROP PP 



(0022, 






The job at the requesting PPU is terminated. The requesting processor is responsible for the dayfile 
message. Operation of this function is identical with function M.DPP except that the error flag in the 
control point area is set to F.ERPP(3) to note the abort function. 
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M.BUFPTR WATCH BUFFER POINTER WORD 

(0044,****,****,00AA,AAAA) 

AAAAAA Buffer pointer address. 

I/O drivers use this function to give MTR the absolute address of the buffer pointer that is being updated. 
MTR monitors the value of that pointer and when it changes, restarts the control point if it is in periodic 
recall. 

M.CCPA CHANGE CONTROL POINT ASSIGNMENT 

(0031 **** **** **** ***>j\ 

The requesting PPU is released from its current control point assignment in the same as though it had 
issued an M.DPP function, but its input register is not cleared. The PPU is assigned to control point N, and 
the new control point number inserted in its input register. 

M.CPJ CAPTURE PERIPHERAL JOB 

(0034,00XX,XXXX,****,****) 

XXXXXX Buffer address, relative to RA 

This request is issued to find a job for a control point either in the event stack or in the PP delay stack. The 
event stack is searched first; if a job is found, its data is written to the buffer whose address is given in the 
request. When the end of the delay stack is reached, the function is exited. 

M.DEQP DROP EQUIPMENT 

(0024 EEEE **** **** ***n^ 

PPMTR drops equipment ordinal EEEE from the control point and updates the EST entry to indicate this 
equipment is free for reassignment. PPMTR does not check to ensure that the dropped equipment was 
assigned to this control point. The parameter N gives the control point number to be considered if the 
requesting PP is attached to control point zero, otherwise it is irrelevant. 

M.DFM PROCESS DAYFILE MESSAGE 

(0013,FFFF.MMMM,****,****) 

Dayfile flag bits FFFF determine message handling: 

Do not send to B display 

1 Do not send to control point dayfile 

2 Do not send to system dayfile (no A display) 

3 Flag as an accounting message 

4 Send to hardware error file 

5 Do not insert job name in system dayfile 
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When the value of MMMM is greater than that in PPOR, it is taken to be the LWA+ 1 of the message in 
the PP message buffer. When the value is less than that in PPOR, MMMM is taken to be a dump index for 
a requested dayfile dump. 

Value of dayfile dump index: 

System dayfile dump 

1 thru N.CP Control point dayfile dump 
N.CP + 1 Hardware error file dump 

M.DPP DROP PPY 

(002 1 FFFF **** ****) 

MTR clears the PP control assignment (the PP status word and the PP input are cleared). If the value of 
FFFF represents M.DPP, the PP time is not incremented. 

M.EES ENTER EVENT STACK 

(00 3 3,00 AA, AAAA, * * * * ,S YTT) 

AAAAAA Word address in Event Stack 

Y Byte address in word AAAAAA 

TT Bit address in byte Y 

S Combined value of F and B: 

F = Event stack job not assigned (F.ESOFF) 

F = 4 Event stack job assigned (EESON) 

B = AAAAAA is an absolute address (F.ESABS) 

B = 1 AAAAAA is relative to RA (F.ESREL) 

B = 2 AAAAAA is a control point address 

(F.ESCPA) 

The event stack is similar to the delay stack and is used by the Scheduler. M.EES writes to the peripheral 
job table, the PP input register, and three parameter words. It then sets up the control point number and 
linkages in the event stack. The new entry is lined to the oldest prior entry then clears the output register 
and exits. A separate chain is maintained for each control point. 

M.INPROC CPMTR FUNCTION IN PROGRESS 

(0400 **** **** **** ****\ 

The CPMTR is processing a function; any CP monitor request made by a PP must wait. 
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M.ISP INITIATE STACK PROCESSOR 

(0027,000X,****,****,CCCC) 

CCCC DST ordinal of stack processor to be initiated 

X = Initiate 1S5 only if PP active flag is zero 

X ^ Initiate 1S5 regardless of PP active flag setting 

A check is made to see if a PP is assigned to this DST ordinal. If there is none, a check for an available PP 
is made. If an available one is found, set the PP active flag and place the DST ordinal and 1S5 in its input 
register. If a PP is found to be assigned to the DST ordinal, the setting of X determines if 1S5 is to be 
initiated or not. If not, the output register is cleared and an exit made; if yes, proceed as for an available 
PP. If the PP job stack is full, the routine is exited. The 1S5 program is the PP input register DST ordinal 
checker and stack processor loader. 

M.KILL BAD FUNCTION REQUEST 

(0077) 

MTR flags the function request as bad and automatically enters STEP mode. The requesting PP is hung. 

M.NTIME ENTER NEW TIME LIMIT 

(0041 TTTTT*** **** ***>j\ 

A central processor job time limit of TTTTT seconds is entered at the control point. Any previous time 
limit is superseded. If the requesting PPU is assigned to control point zero, the parameter N will give the 
number of the control point to be considered; in any other case this parameter is irrelevant. 

M.PASS PPMTR IGNORES FUNCTION REQUEST 

(0036 **** **** **** ****•> 

Indicates a no-operation by PPMTR which will be cleared by another routine. 

M.PATCH INSERT A PATCH IN PPMTR 

(0045,AAAA,BBBB,CCCC,DDDD) 

The routine inserts a patch in the monitor program at the address indicated. 
AAAA Insertion address for patch BBBB 

CCCC Insertion address for patch DDDD 

M.PPCH REQUEST CHANNEL SURVEILLANCE 

(0043,BBAA,DDCC,****,RRRR) 

This routine is a PP extension of the CPMTR function M.RCH (request channel reservation). When 
CPMTR processes a channel request and the request is rejected, the M.RCH function is changed to 
M.PPCH so that a watch can be maintained until the desired channel is available. PPMTR will update the 
channel reject history (DSTRING function CHR) and when the channel is available, change M PPCH to 
M.RCH and initiate CPMTR. 
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M.PPTIME ASSIGN PPU TIME 

(0042 FFFF **** **** ****\ 

MTR adds the current time, minus the PPU starting time, to the accumulated PPU time in the control point 
area (word W.PPTIME). If the value of FFFF represents M.PPTIME, the PP time is not incremented. 

M.RACT REQUEST CONTROL POINT ACTIVITY 

(0037 ***N IIII **** ****■) 

This request provides the various activity counts of control point N at a given time (N cannot be zero). If 
IIII is non-zero, the pseudo-activity count will be incremented or decremented by the constant IIII (after 
sign extension). Monitor replies through the PP output register: 

Byte 1 Control point status byte 

Byte 2 General activity count 

Byte 3 Count of outstanding delayed PP requests 

Byte 4 Pseudo-activity count 

M.RBTSTO REDUCE RBT STORAGE 

^0016 SSSS **** **** ****\ 

PPMTR sets SSSS* 100 as the new RBT starting address. 

M.REQP REQUEST EQUIPMENT 

(0023 EEEE **** **** ***>j\ 

The parameter EEEE consists of two display-code characters: 

if numeric it gives an EST ordinal, 

if alphabetic it defines an equipment type. 

PPMTR will search the equipment status table (EST) for the EST entry. This entry is updated to reflect the 
assignment to the control point of the requesting PPU or to control point N if the PPU is assigned to 
control point zero. Finally, PPMTR places the assigned euqipment ordinal in the first byte of the PPU 
message buffer. If the equipment is not available, a zero byte is returned. 

M.RPJ REQUEST PERIPHERAL JOB 

(0032,DDDD,DDDD,****,****) 

This function requests that another PPU program be initiated after a specified time delay. The first word of 
the requesting PPU message buffer contains the input register image of the new PPU program. The time 
delay is DDDDDDDD*244 (decimal) microseconds. If the time delay is zero and no PPU is available, the 
request is entered in the PP job queue. If no space is available in the PP job queue buffer of PPMTR, the 
entire request remains pending until a queue entry becomes free. 
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M.RPP REQUEST PPU 

(0040, 



jjc j|c Ufa % % * * ^c % * * * * * * # 



This function requests immediate initiation of another PPU program. The first word of the requesting PPU 
message buffer contains the input register image of the new PPU including the control point number to 
which it should be assigned. The input register address of the assigned PPU is placed in the first byte of the 
requesting PPU message buffer. A zero byte is returned and the request is rejected if no PPU is currently 
available. 



PPU ASSIGNMENT 

To control PP assignments, PPMTR keeps (in PP zero) an 8-byte status word for the PPU entries which 
form the PPU Status Table. Each status word has one of two formats, depending upon whether the PP is 
assigned or unassigned and available. 



1 


2 


3 


4 


5 


6 


7 


8 


CPAD 


T.PPSx 


BUFPTR 


APLINK 


JUMPAD 


PPFLAG 


PPSEC 


PPMSEC 



CPAD 

T.PPSx 

BUFPTR 

APLINK 



JUMPAD 

PPFLAG 

PPSEC 

PPMSEC 



Base address of control point area to which PP is assigned 

CM address of PPU status word 

The low order twelve bits of the buffer pointer the last time that 
MTR looked at it. (See M.BUFPTR) 

Active PPU link. This is a pointer to the next member in a chain 
of active PPUs. The chain always starts with MTR (PPO) and 
ends with DSD (PP1). The next PPU is identified by its output 
register index value. 

This is the address saved for re-entry to a partially completed 
monitor function that has been exited via an RJM MAINLOOP. 

Flag is set when PP contains a stack processor 

PP starting time in seconds 

PP starting time in milliseconds 



Bytes 1 through 5 form the word written into location T.PPSx when PPx is assigned. 

When the PP is unassigned and available, the PPU status word is linked in a chain of unassigned and 
available PPs, using byte 5 of the status word (PPFLAG). PP direct cell PPIA contains a pointer to the 
status word at the head of the chain. Byte 5 contains a pointer to the status word of the next available PP. 
If no more PPs are available, byte 5 contains zero. The following diagram illustrates a chain of three 
available PPs. 
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An unassigned PP may exist which is not linked in the available PP chain. This possibility occurs when no 
PP is assigned to a stack processor (PPFLAG not set) and PPMTR reserves a PP for ISP. 

PPMTR assigns a PP by writing a peripheral job name and a control point number into the PP's input 
register to: 

Satisfy a PP program call issued as an RA+ 1 request 

Answer a PP request for another PP job (M.EES, M.RPP or M.RPJ request) 

Initiate a stack processor when an I/O request is issued for a mass storage device to which no stack 
processor is currently assigned 

Call the PP program 1AJ to a control point when all control point activity has ceased 

PPMTR maintains a PP queue table containing a maximum of 40 entries, each 4 bytes long. Each entry 
corresponds to a 4 word entry in the Peripheral Job Table (PJT) in CMR. In the queue, four chains are 
kept: 

A queue of PP jobs which cannot be currently initiated because PPs are not available. This over- 
load queue is a chain of PP input register images. 

A queue of PP jobs which must be initiated after a given time delay. This queue is a time-ordered 
chain of PP input register images, called the delay stack. 
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A separate queue of PP jobs for each control point which must be initiated after a specified bit has 
been set or cleared in central memory. This queue is called the event stack. 

An empty queue of all unused entries in the PP queue. 

Three pointers in PPMTR define the beginning of each chain: 

NPPQ PP overload queue 

NACT PP delay stack 



EMPTY 



Empty chain 



The pointers to the event stack are in the control point table EVST. A fourth pointer, LPPQ, defines the end 
of the PP overload queue. When the time delay expires for an entry in the delay stack, that entry will be 
transferred to the end of the overload queue. 

Chaining of the queue entries uses byte 3 of each 4-byte entry. Bytes 1 and 2 contain the PPFLAG or the 
maturation time for entries in the delay stack. The end of a chain of entries is signaled by zeros in byte 3. 
The following illustrates a PP job queue containing a two-entry overload queue, a one-entry delay stack, 
and the empty chain. 
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M.RSTOR REQUEST STORAGE 

(00 1 7,CCCC,XXXX,00TT,****) 



CCCC Requested CM/ 100 octal 

XXXX Requested ECS/ 1 000 octal 

TT 00 CM request only 

1 ECS request only 

02 CM and ECS request 



03 Request reserved CM 

04 Request CM— will await response 

06 Request CM and ECS-will await response 

07 IP.POSFL requested by swapper 
20 Priority storage requested 



Assign CCCC central memory and/or XXXX extended core storage to the control point of the requesting 
PPU. Monitor replies to this request by setting CCCC and /or XXXX to the values actually assigned to the 
control point and by setting byte to zero. These values should be compared with the original values 
requested to determine whether these requests have been honored or not. A request for more storage is 
rejected if not enough storage is available or if a storage move is already in progress. A request for less 
storage always is honored immediately. If TT = 02, PPMTR can honor part of the request without 
honoring the remainder. 

MEMORY ALLOCATION 

Central memory and direct-access extended core storage is assigned in the same sequence as control point 
numbers. Storage associated with any control point is contiguous. 

All storage is associated with the assigned control points. If no user jobs are assigned to control points, all 
storage is associated with the central memory resident, which operates at control point zero. All storage, 
therefore, falls into one of two categories: 

Allocated storage, defined by the RA and FL of the control point. 

Unallocated storage, defined as that which occurs between the allocated storage of two consecutive 
control points. All unallocated storage is associated with the lower numbered control point. 

PPMTR maintains two tables in PP zero which contain the size of allocated and unallocated CM and ECS 
storage associated with each control point (0 through N.CP). A request for reduced field length will have 
the effect of reducing the amount of allocated storage and transferring the value to unallocated status; no 
storage is actually moved. When the total storage associated with a control point is sufficient, a request' for 
an increased field length will cause transfer of the increased value from the unallocated to allocated state; 
no actual storage move takes place. 

If there is insufficient storage associated with a control point to satisfy an increased field length request, 
unallocated storage may be transferred from adjacent control points. A scan of the unallocated storage table 
entries for the adjacent control points will locate a combination of blocks which results in moving the least 
amount of storage. 
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When a control point RA and/or FL is to be changed, PPMTR will suspend the control point by setting the 
M bit of the CP status byte. If a CM move is necessary, PPMTR will set the storage move flag and wait for 
all PPs assigned to the control point to pause and then initiates the system exchange package to start the 
storage move program. After completion of the move, PPMTR will modify the control point RA and /or 
FL and resume the control point by clearing the M status bit. 

In the case of a request for ECS or a change in FL for control point zero, the storage move flag is not set 
and the wait for PPU pause is not performed. A PPU pause occurs when the field access flag (C.FAF) in 
the PP status word is zero. If an ECS parity error occurs during an ECS move, PPMTR will abort both the 
requesting control point and the control point whose ECS is being moved, if it is no longer intact. 

M.SCH INITIATE INTEGRATED SCHEDULER 

(0035,000X,****, ****,****) 

If X = 2, call the Scheduler, clear the PP output register and exit. Otherwise, check request stack: if full, call 
the Scheduler to empty it before an entry can be made; if not full, make an entry. In either case, advance 
the request stack pointer 

M.SEF SET ERROR FLAG 

(0026,***N,EEEE,****,****) 

Monitor will drop the central program at control point N by putting the program in zero status, and setting 
the error flag to the value EEEE. 

M.SEQ ASSIGN JOB SEQUENCE NUMBER 

(0025 **** **** **** ****\ 

Monitor returns in byte 1 of the PPU output register a job sequence number (in display code). 

M.SPRCL STACK PROCESSOR RECALL 

(OO3O,OOAA,AAAA,0OOF,CCCC) 

This function is called with F non-zero when a stack request has been completed to update the exit count of 
that control point (CPSR), and to update the I/O channel time information (if IOTIME mods are assem- 
bled on) using AAAAAA, which is the millisecond count for PP time inserted by the stack processor. If F is 
zero, only the IO channel time information is updated. 

M.STEP MONITOR STEP CONTROL 

(0015 **** **** **** ***]\j\ 

This control is initiated by a keyboard request. MTR sets an internal step control flag in word T.MSP in the 
CMR pointer area. At each subsequent request, MTR pauses for console keyboard input. A space from the 
keyboard causes MTR to process the request. A period from the keyboard causes MTR to process the 
request and clear the step control flag to resume high speed operation. If N = 0, all PPU requests are 
stepped. If N is non-zero, only control point N is being placed in step mode and only the requests issued by 
PPUs assigned to control point N will be stepped. 
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M.TRACE ENTER MONITOR TRACE MODE 

(0046,AAAA,FFFF,NNNN,****) 

AAAA Absolute address of buffer within requesting field length of re- 

questing job 

FFFF Length of buffer 

NNNN Pointer to next available word-pair in buffer 

A buffer must be provided by the trace mode requestor into which this PPMTR function will write trace 
records. Each record is a two-word entry containing function and PP status information. This function is 
reserved for CDC developmental use. 

M.TSR TERMINATE STORAGE REQUEST 

^0020 **** **** **** ****\ 

Request is valid if real time monitor is installed (IP.RTMTR is non-zero). Terminates wait period involving 
an M.RSTOR request. 



60306500 A 3-35 



FILES AND FILE TABLES 



FILES 

SCOPE 3.4 supports the following file formats: 

Sequential 

Random 

Direct Access 

Indexed Sequential 

A name associated with each file identifies it to the system and to the user. Files are stored on either 
allocatable or non-allocatable devices. Rotating mass storage units, such as disk or drum, as well as ECS are 
allocatable because files on these devices may be allocated to more than one control point. Other devices, 
such as magnetic tapes, card readers, punches, family or sequential packs, and line printers, are non- 
allocatable because they can process only one file at a time. 

Files associated with a job running at a control point are assigned or attached to a control point. Files not 
associated with running jobs are assigned to control point zero. 

Files are associated with one of the following groups: system, input, local, permanent, and output. The 
following paragraphs describe briefly each of the file groups. 

SYSTEM FILES 

The files described below are always in the system; they are always assigned to control point zero and reside 
on allocatable devices called system devices. These files, except for the job dayfile, are maintained on system 
devices as permanent files. 

SYSTEM This file has the name of ZZZZZ04 and contains a copy of the deadstart system tape. 

DAYFILE The system dayfile contains a complete record of all activity in the system. Normally, when a 
message is sent to any job dayfile, it also is sent to the system dayfile. At intervals, the system dayfile can be 
dumped to a line printer, punch, or magnetic tape. 

DFILEn Each user control point in the system has a job dayfile; n is the control point number. These files 
are assigned to control point zero and a user cannot access them directly. When a user job terminates, the 
contents of the job dayfile is copied to the end of the job output file. A job dayfile contains images of all 
control cards processed, appropriate system messages concerning the job run, plus messages sent to the 
dayfile by the job. 
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CERFILE If hardware errors are discovered by running programs, a message is written to this file. 
Periodically, the file is dumped for examination by customer engineers so they can take remedial action. 

ZZZZZ06 If the installation parameter IP.ELIB is one, this file is created to contain the ECS library. 

ZZZZZ23 This file contains a copy of the CM resident library area. It is created by Deadstart and is 
updated by EDITLIB. It is not permanently attached to control point zero and is used only for deadstart 
recovery. 

INPUT FILES 

Jobs may enter the system from sources such as card reader, magnetic tape, or remote devices. In every case, 
a job file is read by a system package operating at a control point which then writes the job to a local file on 
an allocatable device. When the file has been written, its entry in the file name table is altered so that it is 
released to control point zero as an input file. 

The system packages that read in batched local jobs ensure that each job file in the system has a unique 
7-character name. The job name from the job card is truncated to the first five characters (or extended with 
zeros to five characters) and up to two unique sequence characters are added. All numerals and letters may 
be used as sequence characters, therefore 1,296 sequence combinations are possible for a single five- 
character job name. Even though unique combinations are exhausted, duplication of names is not signifi- 
cant unless the earlier job has not been completely processed when the duplicate enters the system. 

LOCAL FILES 

Any files, other than permanent files, attached to a job running at a control point are local files. They may 
be on allocatable or non-allocatable devices. 

Local files assigned to a control point must have unique names. Two local files named INPUT and OUT- 
PUT are associated with each job. INPUT contains the job file; the job name is changed to the name 
INPUT when the job is assigned to a control point. OUTPUT is assigned to the job when the first reference 
to it occurs. It has a disposition code which indicates the job output is to be produced on peripheral devices 
in the area from which the user submitted the job. 

When a local file is detached from a control point, disposition depends on its name, control point, disposi- 
tion code, and device type on which it resides. For local files on non-allocatable devices, the device and the 
related table space will be released. Assigned storage and related table space is released for local files on 
allocatable devices, other than private disk packs, having a zero disposition code (except special name files 
PUNCH, PUNCHB, FILMPR, FILMPL, HARDPL, HARDPR, PLOT, and OUTPUT). For local files with 
other disposition codes the file name is changed to job name and the file is assigned to control point zero. A 
local file with the name PUNCH or PUNCHB will be output to a card punch; the file OUTPUT is printed. 
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PERMANENT FILES 

Permanent files are saved across deadstarts and are therefore considered to be permanent to the system. 
Controls over file access and mode of use are provided to define various degrees of privacy. When a 
permanent file is created, the privacy defined determines which user can access it and the kind of processing 
allowed. 



OUTPUT FILES 

Output files originate from local files on allocatable devices; they have non-zero disposition codes or special 
names, such as PUNCH and PUNCHB. When a job terminates, such files are assigned to control point zero 
and given the job name as a file name. These files then form a system output queue which is, essentially, a 
list of files waiting to be outputted to unit record equipment. 

In each output queue entry a field contains the file disposition code. For example, disposition code 40 
specifies the file is to be printed on any line printer by JANUS. Octal code 10 specifies the file is to be 
punched in BCD format. Code 12 specifies punching with a binary format. 

Local files can be put into the output queue as follows: 

The user can give the file a special name. When a job terminates, the file named OUTPUT is 
always put into the output queue with print disposition code. A file named PUNCHB automatically 
will be put into the output queue with a disposition of 12 (punch binary). A file named PUNCH 
receives a disposition code of 10 (punch BCD). 

The user can specify file disposition on a DISPOSE control card or DIVERT command (INTER- 
COM). The file can have any name. Files on allocatable devices with non-zero disposition are put 
into the output queue. 

Files in the output queue must be on allocatable devices. A file is put into the output queue when the job 
terminates or when a CLOSE, UNLOAD or RETURN is performed. Since the name of an output queue 
file is the name of the job which created it, and since a job may create several files which will go into the 
output queue, names in the output queue often are not unique. 
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SCOPE I/O TABLES 

SCOPE coordinates the requirements of input/output files with the status of input/output devices. File 
tables and device tables are updated continually to provide interface for user jobs and system programs. 

FILE TABLES 

The status and requirements of files is kept in the following tables: File Environment Table (FET), File 
Name and File Status Table (FNT/FST), File Information Table (FIT), and Record Block Table (RBT). 
The FET and FIT are created within the job field length, the other tables reside in central memory resident. 
All are in the upper table area of CMR, except the RBT which resides in the highest addresses of central 
memory. 

The File Name Table/ File Status Table links all user programs and I/O processing routines. A Record Block 
Table contains chains of record blocks for each file assigned to an allocatable (mass storage) device. The 
RBT description is included under Device Tables in this chapter. 

FILE ENVIRONMENT TABLE 

Every file for which I/O is to be performed must have an FET. Each consists of a basic 5-word entry, plus 
additional words depending upon the manner in which the file I/O is to be performed. 
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FILE ENVIRONMENT TABLE 



59 



53 



47 



41 



35 32 29 



23 



6RM- 
CPC- 



17 13 



LOGICAL FILE NAME 



DEVICE TYPE 



DISPOSITION 
CODE 



FET 

LENGTH 

-5 



FNT POINTER 



RECORD BLOCK SIZE 



PRUSIZE 



DETAIL 

ERROR CODE 

(XP=1) 



FWA 
WORKING STORAGE AREA 



POINTER TO 

FET EXTENSION 

(XP=1) 



UBC 



LEVEL 
NO. 



ERROR 
CODE 



CODE/STATUS 



FIRST POINTER 



IN POINTER 



OUT POINTER 



LIMIT POINTER 



PSEUDO IN POINTER 



LWA+1 
WORKING STORAGE AREA 



MLRS (S/L TAPES ONLY) 



RECORD REQUEST/RETURN INFORMATION 
(RANDOM RMS ONLY) 



6RM FET EXTENSION (XP=1) 



RECORD NUMBER (CPC) 



SCOPE INDEX LENGTH 



FWA OF SCOPE INDEX 
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LOCAL FILE NAMES 
FET Word 1 (bits 59-18) 

The following list represents the reserved local file names that appear in a FET for the named 3.4 product 
set file. 



NAME 

ZZZZZ01 

ZZZZZ02 

ZZZZZ03 

ZZZZZ04 

ZZZZZ05 

ZZZZZ06 

ZZZZZ07 

ZZZZZ08 

ZZZZZ09 

ZZZZZ10 
ZZZZZ11 
ZZZZZ12 
ZZZZZ13 
ZZZZZ14 
ZZZZZ15 
ZZZZZ16 

ZZZZZIN 

ZZZZZOU 

ZZZZZRN 



3.4 PRODUCT SET 

EDITLIB 

EDITLIB 

EDITLIB 

EDITLIB 

EDITLIB 

EDITLIB 

EDITLIB 

EDITLIB 

DIAXNOS 



EDITLIB 



USED FOR 

Reset file (permanent file) 
Restore file (permanent file) 
EDITEXTEND file (permanent file) 
System file (permanent file) 
Interpreted EDITLIB directives file 
ECS resident routines library file 
Entry point name table spill file 
Entry point name table spill file 



Program name table spill file 

External reference table spill file 

External reference collection spill file 

Library or deadstart program collection 

Scratch 

PP program name table spill file 

Library name table spill file 



PAGE Utility 
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ZZZZZ17 

ZZZZZ18 

ZZZZZ19 

ZZZZZ20 

ZZZZZ2 1 

ZZZZZDF 

ZZZZZQU 

ZZZZZ22 

ZZZZZ23 

ZZZZZRL 
ZZZZZOP 
ZZZZZRM 

ZZZZZ24 

ZZZZZ25 

ZZZZZ26 

ZZZZZ6D 

ZZZZZ27 

ZZZZECS 

ZZZZZ28 



ZZZZZ31 
ZZZZZ32 



ZZZZZRE 
ZZZZZUN 

ZZZZZSA 
ZZZZZSB 
ZZZZZSC 
ZZZZZSD 



LOADER 

LOADER 

FORM 

FORM 

FORM 

6RM 

QUERY/UPDATE 

6RM 

EDITLIB 

FTN 4.0 

QUERY/UPDATE 

LOADER 
GRAPHICS 
6RM Diagnostics 
LOADER 
EDITLIB 

Debugging Aids 
LOADER 



Entry point list 
Owned global blocks 



Current directory file (permanent file) 



Global library set 



Overlay generator 

System ECS resident library creation job (perma- 
nent file) 



SEGLOAD sort file 

Restricted passwords 
Unrestricted passwords 



SIFT 
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ERROR FLAG LIST 
FET Word 1 (bits 9-13) 

01 END-OF-INFORMATION 

02 END-OF-REEL 
04 PARITY ERROR 

10 DEVICE CAPACITY EXCEEDED 

20 ADDITIONAL ERROR STATUS RETURNED 

2 1 END OF MULTI-FILE SET 

22 FATAL ERROR 

23 INDEX BUFFER FULL 

24 RESERVED 

25 INDEX FULL ON RANDOM READ/WRITE OF RECORD n 

26 NONEXISTENT RECORD NAMED ON RANDOM READ 

27 NONEEXISTENT RECORD NAMED ON RANDOM WRITE AND INDEX IS 
FULL 

30 FUNCTION UNDEFINED ON DEVICE 

3 1 PERMISSION NOT GRANTED 

32 FUNCTION ILLEGAL ON PERMANENT FILE 

33 RESERVED 

34 RESERVED 

35 RESERVED 

36 RESERVED 

37 RESERVED 
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FET FLAG BITS 
Word 2 (bits 47-36) 



BIT 47 (R) 

BIT 46 (N) 

BIT 45 (UP) 

BIT 44 (EP) 

BIT 43 (EB) 

BIT 42 (MUJ) 

BIT 41 (XL) 

BIT 40 (XP) 

BIT 39 (EC) 

BIT 38 (NS) 
BIT 37 
BIT 36 



Process SCOPE index if OPEN/CLOSE; else random read/write 

Release record block as read 

User processing at end-of-volume 

User processing on error condition 

Reserved 

Multi-user job 

Extended label processing 

Extended error processing 

File buffered through or resident in ECS 

File has non-standard labels; processing of label record(s) is left to the user. 

Reserved 

Reserved 
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The basic 5-word FET entry is as follows: 



Record 





59 


47 


35 


32 


23 


reis —, 
17 / 


13 


8 


2 


FET 1 


Logical File Name in Display Code 


~r 


Error 
Flags 


Code 
Status 


MB 


FET 2 


Device Type 


Flag Bits 


Disp. Code 


LFET 
-5 




FIRST 


FET 3 





IN 


FET 4 





OUT 


FET 5 


FNT Pointer 


RB Size 


PRU Size 


LIMIT 



LFET -5 Length of FET minus 5 words for basic entry 



B = Busy (Free = 1) 
M = Mode (Binary = 1) 



Buffer 
Parameters 



LIMIT < FL 

OUT < LIMIT 

IN < LIMIT 

OUT > FIRST 

IN > FIRST 



FET 6 



FET 7 



FET 8 



fwa 



Working 
Storage 



Record Number 



UBC 



lwa+1 Workin9 

Storage 



MLRS 



Record Request/Return Info 



Index Length 



Index fwa 



-1 



-Sequential Files (tape) 

Random/Indexed 
, Files (Mass Storage) 



FET6 is used for input/output blocking/deblocking by CPC 

FET6 and FET7 are used for S and L tape file processing 

FET7 and FET8 are used for indexed file processing by CPC; FET7 is used to pass RMS address between 

CP programs and system PP input/output routines. 



UBC 
MLRS 



unused bit count 

maximum logical record size (S/L tapes only) 
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When the UP and/or EP flags are set in FET2, then FET9 contains: 



59 



47 



29 



17 



FET9 





EOI Return Address 




Error Return Address 



When standard file labels are to be written, the following FET words are filled with information from the LABEL 
control card or macro. When a labeled file is read, the fields will contain data read from the label. 



59 



47 



29 23 



17 



File Label Name (First 10 Characters) 


File Label Name (Last 7 Characters) 


Position Number 


Edition Number 


Retention Cycle 


Creation Date 


6-Character Multi-File Name 


Reel Number 



FET 10 



FET 11 



FET 12 



FET 13 



When XL flag in FET2 is set to 1 for extended label processing, FET 10 has the following format: 



59 



35 



17 



Label Error Code 


Length of Label Buffer 


FWA of Label Buffer 
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SYSTEM FET ENTRIES 

FET entries for the system dayfile, the hardware error file, and the control point dayfiles are kept in the 
upper table area of CMR, adjacent to the control point zero dayfile buffer. The format of the one-word 
dayfile FET entries is: 



59 



47 



35 



23 



11 



Index 


Buffer Size 


Rel Buf Addr 


Limit 


(unused) 



Index is the entry position relative to the table origin (T.DFB). Buffer sizes are set by SCOPE assembly 
configuration parameters internal to CMR. The origin of each buffer is found by adding the relative buffer 
address to the T.DFB origin address of the dayfile buffer area in CMR. The CP zero dayfile buffer is preset 
with a legend in the first eight words as follows: (b represents blank character) 



bDAYFILE: : 
bbbNORMALb 
( bbbbbbbb ) 
DEADbSTART 

COPYRIGHT!) 
CONTROLbDA 
TAbCORP.bl 
9 7 0::::::: 

The system dayfile area in CMR is diagrammed below: 



T.DFB 



Relative 

Buffer 

Addresses 



System FET Entries 



LE.DFBO (buffer size) 



LE.DFBI 



LE.DFB2 



LE.DFB3 



LE.DFB4 



LE.DFB5 



LE.DFB6 



LE.DFB7 



L.DFB 



LE.CERF | 
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FILE NAME TABLE/ FILE STATUS TABLE (FNT/FST) 

To provide linkage between user programs and all I/O processing routines, SCOPE maintains the FNT/ 
FST in CMR upper table area. Each basic entry in the file name table consists of three words; one or two 
three-word extensions to entries may occur in some instances, extending the entry to 6 or 9 words in length. 
The first word contains the logical file name, control point number to which it is assigned, as well as other 
pertinent information. The second and third words constitute the file status table entry; the format of each 
differs, depending upon the type of file and the equipment residence. 

File status entries for each equipment type are as follows. (The C.x(byte) identifiers are listed in the 
diagrams.) 
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FILE NAME TABLE 

ENTRY AND OPTIONAL SUPPLEMENT 
FOR FILE IN INPUT QUEUE 



59 



53 50 47 



35 



23 



17 



i— Link Bit 
11 



C.FNAME 



Job Name 



C.FLINK 




C.FTAPE/C.FNT 


C.FFRBA 


MT 


NT 


First RBT 


Count 


Count 


Word Pair 



C.FCPU 
C.FABT 
C.FRRN 



C.FTL 



Time Limit 



t 



C.ECFL 
ECS FL/1000B 



C.FDC 

Disposition 

Code 



0000 



C.FINTID 
INTERCOM ID 



C.FINFLG 



Job Card Error 

• JANUS Pre-abort 

• Rerun 

00 = CPU-A/CPU-B 
20 = CPU-Aonly 
40 = CPU-Bonly 
60 = 7000 only 
77 = 6000 or 7000 



C.FLNKAD 

Link to 
Supplement 



C.FFL 
CM FL/100B 



C.FPRI 
Priority 



•— Real Time Job 



59 



47 



0077 r 



C.FEQP 
Device Type* 



C.FDPCT 

Job Dependency 

Count 



35 



23 



17 



11 



C.FBKLK 
Backward Link 



C.FFRBA 
First RBT 
Word Pair* 



C.FDPV 

Job Dependency 

ID 



C.FLRBWP 

Current RBT 

Word Pair* 



C.FDC 
Disposition Code* 



0000 



C.FCB 



* ICurr. 
Byte 



C.FLPRU 
Current PRU* 



tlf nonzero, fields apply to pre-OUTPUT file 
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59 



47 



FILE NAME TABLE 

TAPE FILE ENTRIES 

BEFORE EQUIPMENT ASSIGNMENT (GNT) 

17 



•Link Bit 
11 



C.FNAME 



C.FLINK 



Logical File Name 



Control 
Pt. No. 



C.FLNKAD 

Link to Optional 

Supplement 



C.FEQP 
64 



Volume Serial Number 



Allocation Style 



Word 2 from REQ Function Parameter List 



I— VSN Valid 

■ GNT Word 3 Filled in from REQ Parameter List 

■ Label Address in Control Point Area W.CPOAE 

■ Awaiting Tape Assignment 



SUPPLEMENT(S) IF MORE THAN ONE VSN GIVEN 



59 


47 


Multi-Reel File VSNs- 
Alternate VSNs— i 
35 21 




17 


r- L 
15 


nk Bit 

— Control Point Number 
11 


00 7 7 g 


C.FBKLK 
Backward Link 







1 






C.FLNKAD 

Link to Optional 

Supplement 


0000 


Volume Serial Number 


0000 


0000 


Volume Serial Number 


0000 



59 


SUPPLEMENT IF 2MT/2NT DECLARE 

2MT/2NT Supplement —, 
47 35 23 19 


ED 




15 


I — 


Control Point Number 
11 


00 7 7 8 


C.FBKLK 
Backward Link 




1 









0000 


C.FEQP 
Device Type 


C.FTPORD 
T.TAPES Ordinal 


EST Ordinal 


7 7 77 8 


7777 8 
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ENTRY FOR ON-LINE CARD READER FILE 



59 


53 


41 


35 


23 




17 






— Control Pt. No. 

11 


C.FNAME 

Logical File Name 












0000 


60 8 


C.FRECCT 

Record Count 


C.FCREC 
Current 
Record 


C.FPDEV 
EST Ordinal 


00 


E 
O 
J 


C.FLBL 

Card Count 


00 


C.FFETAD 

FET Address 


0000 


Perm 




Code and Status 



ENTRY FOR ON-LINE CARD PUNCH FILE 



59 53 



35 



23 17 



I— Control Pt. No. 

11 



C.FNAME 



Logical File Name 



7 0„ 



00 







0000 



C.FFETAD 

FET Address 



C.FPDEV 
EST Ordinal 



0000 



C.F2PC 
2 PC 
Flag 



Perm 



0000 



C.FLBL 



Card Count 



Code and Status 
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FILE NAME TABLE 



ENTRY FOR LOCAL RMS FILE 
BEFORE ASSIGNMENT TO A DEVICE 



•Link Bit 



Control 



59 



53 



47 



35 



23 



17 



[ Pt. No. 
11 



C.FNAME 



Logical File Name 



C.FCPNUM C.FLINK 



C.FPPFN 




C.FLNKAD 

Link to 
Supplement 



C.FEQP 
Device 
Type 















C.FALLOC 

Allocation 
Style 



Flags 



Family 
Number 



I — Sequential Pack Bit 



Permission Bits 



10 
11 9876 



00 = No ECS Use 
10= ECS Use; Supplement 
Required 

Sequential Pack E/N Bit, or 
Index Write Bit 



£ 



Deferred Assignment 
(Reserved) 
ECS Buffered 
(Reserved) 
Overflow Allowed 
PF Device 



AFTER ASSIGNMENT TO A DEVICE 
AND THROUGHOUT PROCESSING 



59 



53 



47 



35 



23 



17 



■Link Bit 



I — Control 
Pt. No. 

11 







C.FNAME 



Logical File Name 



C.FLNKAD/C.FAPF 

Link or 

APF Pointer 



C.FEQP 
Device 
Type 



C.FFRBA 

First RBT Word 

Pair 



C.FLRBWP 

Current RBT 

Word Pair 



C.FCB 



ICurr. 
I Byte 



C.FLPRU 
Current PRU 



C.FFETAD 



FET Address 



C.FDC 
Disposition Code 



3 



C.FECS/ 
C.FPFREW 



¥: 



Code and Status 



Control Permission 

Modify Permission ' 

Extend Permission 

Read Permission 

FNT Write Bit 






PF Rewrite Bit 
Multi-User Job 

00 = No ECS Use 

10 = ECS Use; Supplement 
Required 
Sequential Pack E/N Bit, or 
Index Write Bit 
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FILE NAME TABLE 



59 



OPTIONAL SUPPLEMENTS FOR LOCAL RMS FILES 
SEQUENTIAL PACK FILE SUPPLEMENT 



47 



35 



23 



17 



-Control Pt. No. 
11 



00 7 7 8 


C.BKLK 

Backward Link 


















T.RPT Ordinal 


Primary EST 


Secondary EST 








Visual Identifier of First Pack 






59 



INTERCOM-USER FILE SUPPLEMENT 
(Required only when file to be attached to swapped-out job) 



47 



41 



35 



23 



-C.FMUJC MUJCode 

-Control Pt. No. 
17 / 11 



i— control Kt. No. 
/ 11 

f C.FAPF 



7 7 



C.BKLK 
Backward Link 



(Reserved for 

Deferred 

Special DISPOSE) 



00 



C.FAPF 
APF Pointer 



User Table Address 



C.FLOCID 
INTERCOM ID 



59 



53 



ECS FILE SUPPLEMENT 



47 



35 



23 



17 



• Control Pt. No. 
11 



00 7 7 8 


C.BKLK 
Backward Link 


(Reserved for 

Deferred 

Special DISPOSE) 




0( 


) 


C.FAPF 
APF Pointer 




Subpage 
Index 


Address of First Subpage 


Address of Current Subpage 




Index 


Auxiliary First Subpage 


Auxiliary Current Subpage 


4? 

L-Buffe 
-1 = ECS 


= Release 
= Output 1 
= Input Bl 
r Overflow 
>-Buffered 


3it 

Buffer 
ffer 

File 
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(C.FDC) DISPOSITION CODE VALUES 

(Byte 2 of word 3 in FST entries, where appropriate) 
Allocatable Devices: 



Code 



RB 

SD 

O 

IP 

Non-Allocatable Devices: 



Bit 

11 

10 

9 

8 
7 
6 



Description 

INTERCOM user file 

INTERCOM batch job 

Reserved 

Special name/disposition file 

File named OUTPUT 

Interrupted print file (not currently implemented) 



Code 



Value 



CK 


XXX 1 


IU 


xxx2 


CI 


xxx3 


sv 


xxx 4 


cs 


xxx 5 




xxx 6 


Low Order 6 Bits: 




Code 


Valui 




01 




02 




03 




04 




05 




06 




07 



Description 

Checkpoint 

Inhibit unload 

Checkpoint and inhibit unload 

Save 

Checkpoint and save 

Reserved 



Description 

Reserved 

Reserved 

Reserved 

Input job ready for scheduling 

Input tape job 

Input tape job on VSN display 

Reserved 
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LOW ORDER 6 BITS OF DISPOSITION CODE (C.FDC) 



Code 


Value 


Output 


Description 


PU 


10 


026 


Punch 026 
character set from 
display code 


f PA 


11 


029 


Punch 029 
character set from 
display code: 
66 = 11-8-2; 
72 = 12-8-2 


P8 


12B 


Absolute 
Binary 


Punch 80 column 
binary 


f P9 


13 


029 


Punch full 029 
character set (96 
characters) 
from extended 
code set 


PB 


14 


6000/7000 
Binary 


Punch 6000/7000 
format binary 


t PZ 


15 


029Z 


Punch with 
COBOL over- 
punch conversion: 

029 character set 

from display 

code: 

66 = 11-0; 

72 = 12-0 


t PF 


16 


029 


Punch folded 029 
character set from 
extended code. 
Lower case is 
folded into upper 
case and 
11-8-2,12-8-2 are 
used 



tNot supported by SCOPE 3.4. 



4-20 



60306500 A 



Code 



t PC 



f FR 

t FL 

| HR 

f HL 

f PT 

PR 
PI 

P2 



Value 


Output 


Description 


17 


029 


Punch folded with 
COBOL over- 
punch conversion: 

029 character set 

from extended 

code. 

Lower case is 

folded into upper 

case 

and 11-0, 12-0 are 

used 


20 




Film print 


21 




Reserved 


22 




Film plot 


23 




Reserved 


24 




Hard copy print 


25 




Reserved 


26 




Hard copy plot 


27 




Reserved 


30 




Plot 


31-37 




Reserved 


40 


CDC-64 


PI or P2 


41 


CDC-64 


501/505 with 
595-1 (CDC) 
graphic set 


42 


CDC-64 


512 with 595-1 
graphic set 



tNot supported by SCOPE 3.4. 
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Notes 



Code 


Value 


Output 


Description 


PE 


44 


ASCII-95 


512 with 595-6 
graphic set 
from extended 
code input 


t AR 


50 


ASCII-64 


Al or A2 


t Al 


51 


ASCII-64 


501/505 with 
595-5 graphic set 


t A2 


52 


ASCII-64 


512 with 595-5 
graphic set 


f AF 


54 


ASCII-64 


512 with 595-5 
graphic set. 
Prints 64 
characters. 
Lower case is 
folded into upper 
case. 



595-1 
595-5 
595-6 



55-67 Reserved to CDC 

70-77 Reserved to 

Installations 



CDC 63 characters and blank are defined. 

ASCII Subset 63 characters and blank are defined. 

ASCII 95 Character Set 94 characters and blank are defined. 



tNot supported by SCOPE 3.4. 
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When the system is assembled, several system file entries are built into the FNT/FST for control point 
dayfiles, system (library) file, and hardware error file. Their initial entries are diagrammed in the following 
figure. 











/-Control Point Zero 
= Unlocked -3/ ^ q 




T.FNT 


Z 


z 


z Z 


Z 4 DDOOOO 





\ Priority 




Device 
Type 





FWAof RBT 
Word-Pair 


Current RBT 
Word-Pair 


Cur RBT 
Ordinal 


Cur 
Byte 


Current PRU 
















7 4 


01 


Status 

01 = Inactiv 




D 


A 


Y F 


1 L E 0000 


























— 









7 4 


01 






D 


F 


1 L 


E 1 000000 



































7 4 


01 






D 


F 


1 L 


E 2 000000 




































7 4 


01 






D 


F 


1 L 


E 3 000000 



































7 4 


01 






D 


F 


1 L 


E 4 


0000 


































7 4 


01 




^ 


I * 






D 


F 


1 L 


E 1 5 


0000 









n 

























7 4 


01 






C 


E 


R F 


1 LEO 


00000 




































7 4 


01 






z 


z 


Z Z 


Z O 3 


0000 









— 


















7 4 


1 












z 


z 


z z 


Z O 6 


10000 


100100100100 


(LE.FNT-1 
\ link addr 


type I 
AX ) 


->o _ 




(ECS library 
< entry if 










7 4 4 


1 








LINK \ 
addr ] 





7 7 


4 4 4 1 
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FILE INFORMATION TABLE (6RM Interface) 

The FIT is created in the field length of a job which uses the Record Manager. It serves to describe those 
files manipulated by Record Manager and is used to that extent in conjunction with the File Environment 
Table. 



59 



47 41 



FILE INFORMATION TABLE 
35 29 



23 17 



LFN 




RL 


P 

M 


FO 




BT 


B 
C 
K 


D 

T 


RT 


D 

K 
I 




PD 


FET 


PTL 


OF 


VF 


CF 


LT 


ULP 


FP 


LX 


HL 
MNR 


BFS 


DX 


TL 


F 
N 
F 




SES 


IRS 


EX 


ES 


VNO 


ECT 


ERL 




S 
P 

R 






OC V 


•i 


L 
C 
R 




LVL 


FWB 


FL 
MRL 


IC 


EC 


C 

M 


EO 


WSA 


KP 


KL 


MKL 


RKP 


RKW 


KA 




IP 


DP 


MNB 


RMK 


PC 


LA 


KT 


LP 


RB 


PAR 


CP 


LL 


LOP 


RC 


CL 






MUL 


BN 




EFN 




TRC 


ECL 


MBL 


NL 


FLM 




PRS 


IBL 


WA 


RESERVED FOR CDC USERS 


HMB 


HRL 




CDT 




DCT 
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FIT TABLE 

WordO 
59-0 
Word 1 
59-36 

35 



LFN 

RL 
PM 



Logical file name 



Current record length in number of characters 

Processing mode (Record Manager only) 

= sequential 

1 = random 



34-32 



FO 



31 
30-28 



BT 



27 



26 



BCK 



DT 



File organization 

000 default 

00 1 word addressable (WA) 

010 direct access (DR) 

1 1 indexed sequential (IS) 

100 library (partition) (LB) 

101 direct access (DA) 

Unused 

Blocking type 

001 default/internal (I) 

010 character count (C) 

1 1 record count (K) 
100 exact records (E) 



Block checksum flag 
Block checksum flag 



= No checksums 

1 = Checksums 



Device type (6RM only) 

mass storage 

1 on-line tape 



60306500 A 



4-25 



25-22 



RT 



Record type 

0000 control word (W) 

0001 fixed length (F) 

0010 record mark (R) 

00 1 1 zero byte (Z) 

100 decimal character count (D) 

0101 trailer count (T) 

0110 binary character count (B) 

0111 undefined (U) 

1000 SCOPE logical records (S) 



21 



20-18 



DKI 



PD 



17-0 
Word 2 
59-36 



FET 



PTL 



Duplicate key indicator 

1 Permission is on an IS file 

Processing directive 

000 

001 

010 

011 

100 



input (INPUT) 
input (INPUT) 
output (OUTPUT) 
input/output (I/O) 
output/input (reverse) 



Pointer to FET 



Partial transfer length, set by GETP, PUTP 
macros 



35-34 



OF 



33-32 



VF 



Open flags (positioning of file at OPENM time) 

00 rewind (R) 

1 rewind (R) 

10 no rewind (N) 

1 1 extend (E) 

End of volume flags (position of file at volume 
CLOSEM time) 

00 unload (default) 

01 rewind (R) 

10 no rewind (N) 

1 1 unload (U) 
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31-30 



CF 



29-28 



LT 



27-25 



ULP 



24-18 



FP 



17-0 
Word 3 
59-36 



35-18 
17-0 



LX 

HL 

MNR 

BFS 

DX 



Close flags (position of file of file CLOSEM time) 

00 rewind (R) 

1 rewind (R) 

10 no rewind (N) 

1 1 unload (U) 

Label type 

00 ANSI standard (ST) 

1 non-standard (NS) 

10 unlabeled (UL) 

1 1 any (ANY) 

User label processing 

000 none 

001 VOL/UVL(V) 

010 HDR/EOV/EOF (F) 

1 1 VOL/HDR/EOV/EOF (VF) 

100 UHL/UTL(U) 

101 VOL/UHL/UTL (VU) 

110 HDR/EOV/EOF/UHL/UTL (FU) 

111 all (VFU) 

File position 



000 
001 

002 

010 
020 
040 
100 



Mid-record 

In header label groups (only set during la- 
bel header processing) 
Beginning of information (BOI) (only set 
on SKIPBu in connection with DX) 
End of section (EOS) 
End of record (EOR) 
End of partition (EOP) 
End of information (EOI) 



Label exit address 

Character length of fixed header of a type T 
record 

Minimum character length of type R record 

CIO buffer size (number of words) 

End of data exit routine address 
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Word 4 
59-36 

35-18 

35 

30-27 



26-18 
17-0 
Word 5 
59-54 

53-45 

44-36 

35-34 

33 

32-31 



TL 

ES 

FNF 

SES 



IRS 
EX 

VNO 

ECT 
ERL 

SPR 



Character length of trailer portion of type T 
records 

Error status 

Fatal/non-fatal flag (1 = fatal) 

System error subfield 

1 Read parity level 1 

02 Read parity level 2 

03 Read parity level 3 

04 Read parity level 4 

05 Write parity level 1 

06 Write parity level 2 

Invalid request subfield 
Error exit routine address 



Current volume number of multi-volume sequen- 
tial file 

Current error count 

Error count limit 

Unused 

Suppress read ahead ( 1 = suppress, = no) 

Unused 
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30-29 



OC 



28 

27 
26 

25-24 
23-18 
17-0 
Word 6 
59-36 

35-31 



FWI 

ON 
LCR 



LVL 

FWB 

MRL 

FL 

IC 



30-26 



EC 



Open/close 

00 never opened 

1 open 
10 closed 

Forced write indicator for IS file blocks 
( 1 = forced write; = no) 

Old/new file (1 = new) 

Label action on PD tape (PD = I/0) 

create new labels (N) 

1 check existing labels (E) 

Unused 

Level number of S-type record 

fwa of user I/O buffer 



Maximum record length 

Length of an F or Z type record (characters) 

Internal character code 

00 CDC display code 

01 I 

> not available 

37) 

External character code 
00000 CDC display code 
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25 



24-22 



21-0 

Word 7 
59-56 

55-47 
46-38 
37-34 
33-22 
35-29 
28-22 
21-0 



CM 



EO 



WSA 



KP 

KL 

MKL 

RKP 

RKW 

IP 

DP 

KA 



Conversion mode 

1 convert from EC to IC 

no conversion 

Parity error options 

000 terminate job (T) 

00 1 drop erroneous data (D) 

010 (unused) 

1 1 accept erroneous data (A) 

100 display data and terminate job (TD) 

101 unused 

1 10 accept and display erroneous data (AD) 

1 1 1 (unused) 

First word address of user work storage area (user 
record area) 



Starting character position of record locator key 
specified in KA 

Key length 

Major key length in number of characters (IS) 

Relative keyword position (DA files) 

Relative keyword position in RKW (DA files) 

Index block padding factor (% padding) 

Data block padding factor (% padding) 

Address of record locator keys (key field address) 
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Word 8 
59-36 

35-28 
27-22 



21-0 
Word 9 
59-36 



35-22 

21-0 

Word 10 

59-36 

59-36 

35-30 

29-0 



MNB 
RMK 
PC 
KT 



LA 

CP 

LP 

RB 
PAR 

LL 
CL 
LOP 
RC 



Minimum block length 
Record mark character 
Padding character for sequential file blocks 

Key type for indexed sequential files 

000 symbolic (S) 

001 symbolic (S) 

010 integer (I) 

011 floating (F) 

100 computational- 1 

101 actual (A) 

110 computational-2 

First word address of user's label area 



Beginning character position of trailer count field 
(type T record) 

Beginning character position of record length 
field (type D record) 

Number of records per K type block (BT = K) 

Parameter list address 



Length of record length field (RT = D) 
Length of trailer count field (RT = T) 
Last operation code (6RM only) 
Record count 
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Word 1 1 

59-36 

35-30 

29-0 

47-30 

23-18 

17-0 

Word 12 
59-36 
35-30 
29-0 

17-0 

17-0 

Word 13 
59-36 
35-0 



LBL 

MUL 

BN 

EFN 

TRC 

ECL 



MBL 

NL 
FLM 

PRS 

DL 

IBL 
WA 



Length of user's label area (number of characters) 

Multiple of characters per K, E type block 

Block number of current block 

Error file name word address 

Number of transactions to be traced (IS or DA 
files) 

Error code location (address of SIS V1.0 error 
code) 

Maximum block length 

Number of index block levels (IS files) 

File limit in words per file (FO = WA) or number 
of records per file (FO = IS) 

Previous record length (FO = SQ) after a forward 
sequential GET 

Library file directory length (7DM only) 



Index block length (words) 

Current position word address set by GET, 
GETP, PUT, PUTP and SEEK macros 
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Word 14 Reserved for users 

Word 15 

59-30 HMB Number of home blocks of a DA file 

29-0 HRL Address of key hashing routine for a DA file 

51-30 CDT Collating sequence to display code conversion ta- 

ble address for IS file 

21-0 DCT Display code to collating sequence conversion ta- 

ble address for IS file 

Words 16, 17, 18, are scratch words used by 6RM. 
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DEVICE TABLES 

Tables in CMR that provide information on input/output equipment and channels are used by SCOPE to 
make file assignments. Tables included in this section: Equipment Status Table (EST), containing entries for 
all I/O equipment in the configured system; Device Status Table (DST) and Device Activity Table (DAT), 
providing information related to mass storage devices and controllers; Record Block Reservation (RBR) and 
Record Block Table (RBT) containing information of each record block in a mass storage device. The 
Channel Status Table (CST) provides I/O channel availability information and serves as an interlock for 
major file tables, which prevents modification of the same table entry by two or more programs. Also 
included are the TAPES table and the Tape Staging Table (STG), the Rotating Mass Storage (RMS) table, 
the Device Pool Table(DPT), the Removable Pack Table (RPT) and the INTERCOM table (ITABL). 

HARDWARE MNEMONICS AND DEVICE TYPE CODES 



Mnemonic 



Device 
Type 



Description 



AA 
AB 

AC 

AL 
AM 
AP 
AF 

AD 



MT 

NT 



TR 
TP 



LP 

LI 



01 

02 

03 

04 

05 

06 

07 

10 

11 

12 

13-17 

21-27 

30-37 

40 

41 

42 

43 

62 

63 

44 

45 

46 

47 

50 

51 



6303-1 disk 

6638 disk 

data cell 

6603-11 disk 

821 data file 

841 multiple disk drive 

3234/854 disk pack drive 

814 disk file 

CDC reserved 

3637/865 drum 

CDC reserved 

CDC reserved 

Reserved for installations; mass storage only 

7-track magnetic tape 

9-track magnetic tape 

Member file 7-track tape 

Member file 9-track tape 

7-track multi-file set tape 

9-track multi-file set tape 

Paper tape reader 

Paper tape punch 

Reserved for installations 

Reserved for installations 

501, 512, 505 line printer 

501, 505 line printer 
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Mnemonic 
L2 



CR 
KB 



CP 
DS 
GC 
HC 
FM 
PL 

DC 

IX 

SC 

YC 

CC 



Device 
Type 

52 

53-55 

56-57 

60 

61 

64 

65 

66-67 

70 

71 

72 

73 

74 

75 

76-77 



Description 

5 12 line printer 

CDC reserved 

Reserved for installations 

405 card reader 

Remote terminal keyboard 

Pseudo code for tape staging 

CDC reserved 

Reserved for installations 

4 1 5 card punch 

6612 keyboard/display console 

252-2 graphic console 

253-2 hard copy recorder 

254-2 microfilm recorder 

Plotter 

Reserved for installations 

6671 DSC 

Reserved for installations 

6673/6674 DSC 

6676 DSC 

6000/7000 channel coupler 



EQUIPMENT STATUS TABLE (EST) 

The Equipment Status Table resides in the upper table area of CMR and is pointed to by P.EST in the 
CMR pointer area. Table length is variable depending upon the system configuration at deadstart. There- 
fore, the CMR pointer word also includes the LWA+ 1 address of the EST. 

The EST contains a one-word entry for each device configured in the system, including consoles and remote 
terminal MUX devices. Each entry describes current status of the device and includes the device hardware 
mnemonic name, channels to which it is attached, device unit number, etc. 

Entries in the EST are numbered starting with one; an entry number, called the EST ordinal, is used to 
identify the table position of each equipment entry. The EST ordinal of the equipment being assigned is 
given as xx in the operator type-in n.ASSIGNxx. 

The EST is the basic reference for most other I/O tables. EST ordinals are found in the FNT/FST entries 
for linking file entries to their assigned equipment. EST ordinals in the TAPES table link tape entries to 
related equipment entries in the EST. Likewise, EST ordinals are found in the Record Block Reservation 
(RBR) table, linking that table to the allocatable device it describes. 
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(T.EST) EQUIPMENT STATUS TABLE 



PUBLIC RMS DEVICE ENTRY 

59 47 



C.ESTAT 
11001 I I 1000000 



t 



C.ESTDL 
Device Label 
RB 



35 32 29 



23 



Eqp. 
No. 



Unit 
Number 



S.ESTSYS - System Device 
l — S.ESTPFD — Permanent File Directory Device 
S.ESTPF — Permanent File Device 



11 



C.ESTMNE 
Hardware 
Mnemonic 



L-ON/OFF Bit 



C.ESTDST 
DST Ordinal 



PRIVATE RMS DEVICE ENTRY 

59 51 47 



35 32 29 



C.ESTAT 
l|00000 



t 







Eqp. 
No. 



Control Point Number 

S.ESTBSY- BUSY Bit 
S.ESTFR-FREE Bit 



23 



Unit 
Number 



t 



C.ESTMNE 
Hardware 
Mnemonic 



11 



ON/OFF Bit 



C.ESTDST 
DST Ordinal 



MAGNETIC TAPE ENTRY 



59 



51 



47 



41 



35 



C.ESTAT 
000000 



t 



C.ESTCH1 



Channel 
2 



Available 
Bit 



U— H_1|L 

■— Control L_ 



IChannel 
1 



29 



23 



C.ESTCH2 



Channel 
4 



• Control 
Point 
Number 



6681/6684 



Channel 
3 



t 



C.ESTMNE 
Hardware 
Mnemonic 



ON/OFF Bit 



■ Tape Status 
Check in Progress 



11 8 



Eqp. 
No. 







t 



Unit 
Number 



MMTC 
Bit 



UNIT RECORD EQUIPMENT ENTRY 

59 51 47 41 



35 



C.ESTAT 
000000 



•— Available ■— 
Bit 



C.ESTCH1 



00 



Channel 



Control Point Number 



23 



C.ESTSD 

Special 

Disposition 



t 



C.ESTMNE 
Hardware 
Mnemonic 



11 8 



Eqp. 
No. 



ON/OFF Bit 







Urvit 
Number 



4-36 



60306500 A 



6612 DISPLAY CONSOLE ENTRY 

59 51 47 41 



35 32 29 



23 



11 



C.ESTAT 



t 



C.ESTCH1 

Channel 



Eqp. 
No. 



Unit 
Number 



Control Point Number 



•— Available Bit 



t 



C.ESTMNE 
DS 



ON/OFF Bit 







MULTIPLEXER ENTRY 

59 47 



41 



35 32 



23 



11 



C.ESTAT 



TT 



C.ESTCH1 
Channel 



Eqp. 
No. 







Available Bit 



t 



C.ESTMNE 
Hardware 
Mnemonic 



ON/OFF Bit 



Index into 
MUX Subtable 



6000/7000 CHANNEL COUPLER 
59 47 



35 



C.ESTAT 



t 



C.ESTCH1 
Channel 



Eqp. 
No. 



23 



000 



t 



C.ESTMNE 
CC 



11 



0000 



Control Point Number 



ON/OFF Bit 
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DEVICE STATUS TABLE (DST) 

The stack processor uses the device status table in processing of mass storage files. The DST is located 
adjacent to the request stack in CMR upper table area. Each controller has one DST two-word entry which 
specifies the overlay to be used by the stack processor (ISP) for each controller, pointers to a chain of 
requests entered in the request stack for that controller, and device availability information. 

Each entry is numbered, starting from 1, to identify DST ordinals. The format of a DST entry is: 



59 



47 



41 



35 



23 



17 14 11 



Reserved for 
CDC 


Driver 
Name 


Res. for 
Inst. 


Pointer to End 
of Chain 


Alt. 
Channel 


Pri. 
Channel 


DST 
Ordinal 


Head 1 
Position 


Head 2 
Position 


Pointer to 
Start of Chain 


Res. for 
Inst. 




E 


Non-Zero if a 
PP is Assigned 



Word 1 of the entry contains the driver overlay code which enables the stack processor to have the correct 
mass storage device overlay loaded. The code is keyed to the type of controller; it is used to form the driver 
name 3Sx where x is: 



P 

Q 
R 

S 
T 

U 
V 

w 



6603-1 Disk 
6638 Disk 
865 Drum 
854 Disk Pack 
6603-11 Disk 
814 Disk 
821 Disk 
841 Disk Pack 



In word 2, if only one unit is attached to the controller, the head position unit 2 byte is not used. Also in 
word 2, if no 3000 controller is related to the entry, the field is zero; otherwise, it contains the 6681 
converter unit number, 1 to 3. If the chain start and chain end pointers are not equal, a PP is assigned to 
process the stack entry chain. The assigned PP address is given in byte 4 of word 2; when the entry is 
completed and the PP is dropped, the byte is set to zero. 

The device status table is a key table in the processing of allocatable storage files. DST ordinals are found 
in the Device Activity Table (DAT), the Record Block Reservation (RBR) table header, and the Equipment 
Status Table (EST). A DST ordinal appears in each DST entry; it is placed into the input register of the PP 
assigned to process an entry for that device in the request stack. 
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DEVICE ACTIVITY TABLE (DAT) 

The device activity table is directly related to the device status table. It has one entry for each DST entry 
and is referenced by the mass storage device open overlay (3DO) in determining the best RBR to assign to 
a new or overflowing file. 

Format of one-word DAT entry: 



C.DATDST 

DST 
Ordinal 



C.DATEQP 

Eqp. 
Type 



C.DATACT 
Activity 



Count 

Maintained 

By SPM 
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DEVICE POOL TABLE (DPT) 

The device pool table contains a 10-word area for each RMS device. Both ISP and 1EP routines use this 
area for passing their pool tables to each other. 



T.DPT 

1 
2 
3 
4 
5 
6 
7 
8 
9 
10 



59 



Internal Information Passed Between IEP and ISP Each Time One Calls the Other 
47 35 23 11 



Ai 


A 2 


A 3 


A 4 


A 5 


A 6 


A 7 


A 8 


A 9 


A 10 


An 


A 12 


Bi 


B 2 


B 3 


B 4 


B 5 


B 6 


B 7 


B 8 


B 9 


B 10 


B n 


B 12 


Ci 


c 2 


c 3 


c 4 


c 5 


c 6 


c 7 


c 8 


c 9 


C 10 


Cn 


c 12 


(Reserved) 


X 


Y 


Z 


Zi 


z 2 


z 3 


z 4 


z 5 


z 6 


z 7 


(Reserved) 


(Reserved) 


(Reserved) 



A; 



11 




5 


4 


3 


2 







Stack Request Ordinal 


ECS 
Bit 


PRI 
Bit 


Unit 
Number 



First Physical Sector 
for Latency Calculation 


Write 
Flag 


t 


Subpriority 



11 



Subpriority Overflow Field 



Standard First RB Number for 
Positioning Time Calculation 



11 



Ordinal of S.R. that may be Reissued 



Y 



Number of S.R. Waiting in Pool 



No. of S.R. in Pool for Unit K, 0<K<7 
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CHANNEL STATUS TABLE (CST) 

The Channel Status Table, residing in the lower table area of CMR, contains a one-word entry for each 
hardware channel and each pseudo channel in the system. For a reserved channel, the PP reserving the 
channel is identified in the entry. When a channel is not reserved, the CST entry format is: 



59 




47 C.CSTCN 


35 


C.CSTCB 


25 


23 




11 










Channel Number 




C 


X 


X 



If a channel is being used by a PP program, the entry format is: 
59 47 C.CSTCN 35 C.CSTCB 25 23 



11 






Channel Number 




C 


X 


PPI R Address 



X 

c 



Address of this word 
MMTC conversion table flags 

00 No table 

01 EBCDIC 

10 ASCII 

1 1 Reserved 
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The channel number is obtained by a PP program from the EST entry for the type of equipment. The 
length of the CST includes entries for a minimum of 12 hardware channels (optionally 24 maximum) and 
13 pseudo channel numbers. Channel number assignments are listed in the following table. 

CHANNEL NUMBERS 

00 thru 13 Hardware Channels 

1 4 CH.FST (controls access to FST) 

1 5 CH.FNT (controls access to FNT) 

16 CH.LIB (controls access to LIB for 250 Graphics software only) 

1 7 CH.RBT (controls access to RBT) 
20-33 Hardware Channels 

34 CH.CPA (control point area interlock) 

35 CH.PFM (Permanent file manager channel) 

36 CH.INS (for use by installation) 

37 CH.DMP (represents dump channel) 

40 CH.EST = CH.TAPE (controls access to EST/TAPES table) 

4 1 CH.ICTPT (INTERCOM control point channel) 

42 CH.IEMBF (INTERCOM empty buffer channel) 

43 CH.IUSER (INTERCOM user table channel) 

44 CH.SCH (Scheduler channel) 

Access to the FST/FNT/RBT is controlled by an interlock scheme which prevents two or more programs 
from attempting to modify the same table entry at the same time. Not all table accesses require pseudo- 
channel reservations. Some of the conditions which require pseudo channels are: 

Entry is added to FNT 

File is assigned to a control point, causing FNT modification 

FST code/status byte is initialized 
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Tables related to file processing on non-allocatable devices: 





FET 






i 


i 


FNT Pointer 








EST 


















CST 


FET Pointer 


FNT/FST 






















FNT Poi 


nter 




TAPES 
















STG 





EST Ordinal 
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T.TAPES TABLE 





59 


47 


35 


29 


23 


17 


11 




EST Ordinal 
(Binary) 


FNT Address 


Control Point 
Number 


MT or NT 
(Display Code) 


EST Ordinal 
(Display Code) 


W.TFLN1 


Label Name 




Label Name 


Position Number 




Edition Number 


Retention Cycle 


Creation Date 


W.TREEL 


Multi-File Name 


Reel Number 


W.TFLGS 


C.TFLGS 

Flag Bits 




W.TVRN 


Volume Serial Number of Current Reel 


Channel Byte Count 
of Previous Record 


W.TVRN1 


Volume Serial Number of First Reel 


PRU Number of Last PR U 
That Got Noise Warning 1 



C.TFLGS - Job-Oriented Flag Bits 



59 58 57 56 55 54 53 52 51 50 49 48 



S.TTFGO-Gobit 
S.TTFRC— Recheckbit 

(Reserved) 
S.TTFST — Stop Staging 
(Reserved) 
(Reserved) 



GO 



d" 



RC 



ST 



VP 



MP 



LC 



EC 



+J 



Label expiration checked — S.TTFEC 
Label checked — S.TTFLC 
Multi-file position bit — S.TTFMP 
VSN-printed bit - S.TTFVP 
(Reserved) 
(Reserved) 



C.TFLGS+1 - Unit-Oriented Flag Bits 



47 46 45 44 43 42 41 40 



38 37 36 



S.TTFVT- VSN read from tape 
S.TTFOV- Operator-supplied VSN 
S.TTFSC - Scratch 
S.TTFRD- Ready 

(Reserved) 

(Reserved) 



VT 



IT 



OV 



SC 



RD 



EL 



BL 



LB 



FS 



Rl 



WN 



t 



Unexpired label w/ring— warning — S.TTFWN 

- Ring in bit -S.TTFRI 

- Flash save bit — S.TTFFS 

- Labeled — S.TTFLB 

- Blank labeled -S.TTFBL 
-Expired label - S.TTFEL 
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TAPE SCHEDULING TABLE 



59 



C.STGMT 47 C.STGNT 



35 



23 



11 



W.STGMAX 



W.STGFRE 



W.STGSAT 



W.STGUFD 



Number of 
MT Defined 


Number of 
NT Defined 


(Reserved) 


(Reserved) 


(Reserved) 


Number of 

MTON + 

Unassigned 


Number of 

NTON + 

Unassigned 














Number of MT 

Held by 
Satisfied Jobs 


Number of NT 

Held by 
Satisfied Jobs 














Unfilled 
MT Demand 


Unfilled 
NT Demand 















(Total) 



(Available) 



(Assigned) 



(Unfilled 
Demand) 
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NON-ALLOCATABLE DEVICES 

TAPE DRIVE SCHEDULING 

The purpose of tape drive scheduling is to improve the overall system throughput, particularly as it relates 
to tape job setup and execution. The features of the tape scheduling scheme are discussed in the next 
paragraphs. 

AUTOMATIC TAPE DRIVE ASSIGNMENT 

Because ANSI tape labels include a volume serial number (VSN) field, it is possible for the user to have 
tape drives assigned automatically to his ANSI-labelled tapes by specifying the VSN as a parameter on the 
REQUEST control card. This feature does not encroach upon automatic assignemnt by label as in SCOPE 
3.3. The VSN parameter declares that the tape label is either type U (full ANSI-standard label) or type Z 
(existing SCOPE "standard" label). The Z labels are not ANSI standard, as the recording density field 
(character 12 of the volume header label) is not standard. 

Automatic tape assignment by VSN allows a form of automatic assignment of unlabeled tapes. In such 
cases, the VSN must first be entered by the operator, whereupon the tape will be assigned automatically to 
any and all jobs which name its VSN. U-labeled (formerly Y-labeled in SCOPE 3.3) tapes do not contain 
VSN information. They may be automatically assigned by label or by VSN, if the operator first enters the 
VSN through the console. 

VSN CONTROL CARD 

The VSN card relates the physical tape reel number (VSN) to the logical file name and also provides 
information required for the tape job prescheduling display. When used with the REQUEST and/or 
LABEL control cards or the REQUEST function, it serves to relate a VSN to a logical file name, which is 
important to automatic equipment assignment. Used by itself, it serves no purpose other than supplying 
data for subsequent use in the job prescheduling display. 

TAPE JOB PRESCHEDULING 

The tape job prescheduling display is an extension of the P-display and lists, by VSN, the tape reels 
required by each tape job. A tape job is defined as one having MT and/or NT parameters on its job card. 
All incoming tape jobs are entered in a prescheduling queue, a subset of the input queue. The purpose of 
having a prescheduling queue is to advise the operator of tape reel requirements and to hold jobs in 
abeyance until such reels can be obtained from the tape library. This arrangement also allows the operator 
some control over the selection of tape jobs for execution. 

The operator communicates with the prescheduling queue through DSD type-ins and the P-display. Each 
time the P-display is requested, tape jobs having the highest priority are displayed. A job requiring tapes is 
not placed in the normal job input queue until the operator releases it with a type-in. Once released, the job 
will be considered by assignment to a control point and execution; it will no longer appear in the presched- 
uling display. 
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JOB SCHEDULING WITH TAPE DRIVE OVERCOMMITMENT 

Job scheduling based on tape drive overcommitment assumes that a tape job does not always need its 
maximum tape requirement for the duration of the job. Overcommitment takes advantage of the assump- 
tion that must of the processing activity of a job is done using less than the maximum number of drives 
neccessary for job completion; therefore a job is assigned only those drives it needs to continue execution at 
any instant in time. Its unneeded drives at that instant are made available to run other jobs. 

Such a job scheduling algorithm would permit the total tape requirements of all active jobs to exceed the 
tatal number of drives in the installation, which could result in too many jobs requesting too many tapes. 
For example, two or more jobs whose maximum tape requirements have not been met can create a system 
deadlock by typing up all the tape units in the installation. The only way to resolve such a deadlock is to kill 
one of the competing jobs and rerun it at a later time. 

A deadlock prevention algorithm is provided in SCOPE 3.4 as a part of REQUEST processing. Deadlock 
prevention is a function of tape assignment, not one of job scheduling, although the job scheduling algo- 
rithm has some built-in deadlock prevention features. The function of deadlock prevention is to refuse any 
assignment (manual or automatic) of a tape to a job if that assignment creates a potential deadlock. A 
potential deadlock is detected when two or more jobs whose maximum tape requirements have not yet been 
met have been assigned tapes in such a manner that there are not enough free units remaining to satisfy the 
maximum demand of any one of them. Tape jobs could be scheduled at random and the deadlock algo- 
rithm would evade such deadlocks, but the resulting refusal of tape assignments would cause operator 
confusion and loss of efficiency. Job scheduling based on tape drive overcommitment, therefore, attempts to 
create an optimal situation while deadlock prevention avoids the worst-case situations. 
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DYNAMIC TAPE DRIVE STATUS CHECKING 

Information concerning the physical status of tape drive units is entered into the TAPES table and kept up 
to date by periodic checks of unassigned units for a ready/not-ready status. The period for status checking 
is set by the installation; it must be short enough to preclude the occurrence of an operator dismounting a 
tape from a drive unit and mounting another without detection. Such periodic checking of unassigned tape 
drives makes automatic assignment more efficient and flexible. 

When a tape drive is set to not-ready status, the fact is noted in the TAPES table and the unit becomes 
available for assignment to a job. When a drive is put in the ready status, the TAPES table is updated with 
information read from the tape label. (If the tape is unlabeled, this fact is noted in the table.) A search is 
then made for a job that needs the tape and the tape is assigned to it, providing such an assignment will not 
cause a deadlock. This action holds true both for labeled tapes and tapes qualifying as scratch, per IP.TSG. 

Whenever a requested tape cannot be located immediately, the requesting job is rolled out until the opera- 
tor mounts the tape. When the tape is found, it will be automatically assigned to the requesting job and the 
job rolled back into CM to continue processing. While the job is rolled out, the operator may make a 
manual tape assignment which will cause the job to be rolled in automatically. 

Dynamic tape drive status checking permits the automatic assignment of unlabeled tapes by volume serial 
number. A VSN entered by the operator is recorded in the TAPES table; as long as that drive remains in 
the ready status, the system knows that the tape is still mounted and that it may be assigned without 
operator intervention to any job requesting that VSN. 

Dynamic status checking also provides an improved scheme for reel swapping of multi-reel files. The 2MT 
parameter is no longer required on the REQUEST card; however, it is supported for the sake of compati- 
bility. Whenever an end-of-tape before end-of-file mark is encountered, SCOPE will automatically search 
the TAPES table for the next reel of that file. If the needed tape is located, the unit on which it is located 
will be assigned to the job and the original unit deassigned. If the tape cannot be found, an appropriate 
message is posted to the operator; he may respond by either mounting the required tape or making a 
manual assignment. 

Reel swapping will take place regardless of whether the file was scheduled by VSN or by label reading. For 
input tape reel swapping by label, SCOPE searches the TAPES table for a duplicate of the current label but 
with the reel number incremented by 1. For output files, SCOPE simply looks for another scratch tape. In 
reel swapping, deadlock considerations are irrelevant because one tape drive is beign assigned while an- 
other is deassigned. 
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ROTATING MASS STORAGE DEVICES 

Figure 4-1 illustrates the various types of RMS devices, the definitions of which follow: 



Non- 
allocatable 




Allocatable 



Free 



Busy 
Figure 4-1 . RMS Device Types 



Private Device 



Public Device 



Non-Allocatable 



Allocatable 
Device 



Free 
Busy 



A device which can only be assigned with an explicit request. A private device is 
logically removable, therefore may be used for family packs (formerly called private 
packs) and for sequential packs. 

A device which can be assigned by default. Public devices are allocatable and logically 
non-removable. Examples are system device, permanent file device, and permanent file 
directory device. 

A device which can be assigned only to one job at any one given time. Sequential 
packs and family packs are private, non-allocatable devices: assigned by explicit re- 
quest, assigned only to one job at a time, and logically removable. 



A device that can be shared by more than one job at a time. Allocatable devices may 
be either private or public. A public allocatable device may be a system device, PF 
device, or PFD device, which are assigned by default. A private allocatable device 
example would be a system permanent pack. 

A term used only for private devices which indicates the device is logically not in use. 

A term used only for private devices. Indicates that the device is logically in use; its 
existance and type of data is know to the system. 
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DISK PACK DEVICES 



A disk pack device may be designated at system deadstart as a public, private, or system permanent device. 
A public device is treated the same as any other disk pack device; it may contain one or more files of 
various types which may be assigned to different control points. The device itself is not assigned to any 
control point. A disk pack on a public device is not removable. 

FAMILY PACKS 

A family pack may contain one or more files which are referenced by only the control point to which it is 
explicitly assigned by an RPACK control card. Assignment of a family pack to a private device causes FNT 
entries to be made for each file resident on the pack; no further action is necessary to reference the files. 
New files may be created on the pack by using a REQUEST card; unwanted files may be removed by using 
a REMOVE card. At job termination, all information about each file residing on the pack is written back to 
the pack before the information is cleared from memory. 

A single family of files may reside on as many as five disk packs. All packs in the family must be mounted 
on private devices and remain mounted until the job terminates. Subsequent disk pack devices will be 
assigned automatically as files are being created on the packs, up to the limit of five. 

SEQUENTIAL PACKS 

One or more disk packs may be used to contain a single file whose size may span as many packs (volumes) 
as are needed. A private, non-allocatable (removable) disk pack device must be explicitly assigned to the file 
by a REQUEST card; the file may be referenced by only the control point making the request. Only the 
pack (volume) containing the file portion to be used needs to be mounted on the assigned device. 

The method used for volume swapping depends on the manner in which equipment used for the file is 
requested. If a single device is requested, the operator must mount packs in sequence on that device; if two 
devices are requested, the operator must mount packs in ping-pong sequence, beginning with the first 
device assigned. Volume swapping will occur automatically or may be controlled by the user. Processing on 
a given volume may be terminated prematurely by a CLOSER function; the next volume will then be 
available. A return to the first volume of the file may be effected by a CLOSE function. 

SYSTEM PERMANENT PACKS 

System permanent packs allow the addition of permanent files to a system without requiring loads from 
tape, provided that these files have been created on physically removable disk packs. The system permanent 
pack feature is a new addition to SCOPE. 

All packs to be used as system permanent packs must have been declared to be permanent file devices 
during deadstart, since these packs will contain all permanent files known to the system. The number of 
packs cannot exceed the number of available devices, as all packs must remain mounted while the system is 
running. 
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Tables related to file processing on allocatable devices: 



FET 



FNT Pointer 



FET Pointer 



RBT Word-Pair 
Ordinal 



RBT Address 
Index 



EST 



CST 



FNT/FST 



EST 
Ord. 



DAT 



REQUEST 
STACK 



RBR 



DST 



DST Ordinal 



RMS 



RPT 




DST 
Ord. 



RBR 
Ordinal 
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REMOVABLE PACK TABLE ENTRY (RPT) 



C.RPTEST 
C.RPTVID 



C.RPTFST 



C.RPTCP 



C.RPTPKN 



59 




47 


35 




23 


11 00 


EST 
Ordinal 
(Binary) 


FST 
Address 


Control 

Point 

Number 


A M 
« or _ 
A P 

(Display Code) 


EST 

Ordinal 

(Display Code) 


Visual Identifier (VID) 
of Current Pack 


Pack Number of 
Current Pack 



RMS TABLES 

To comprehend the functions of the various tables involved, the methods of mass storage space allocation 
must be understood. Terms are denned below: 

SECTOR: the smallest accessible physical space increment on a track of a rotating mass storage device. 

PRU: (physical record unit): the smallest amount of data a user may access; it is 64 decimal (100 octal) 
central memory words and is usually equal to 1 sector. 

RB (record block): an increment of allocatable space on a mass storage device (RMS or ECS), usually a 
number of PRUs. 

RBR (record block reservation): a bit-coded table which indicates those RBs on a device which are 
assigned to a file, flawed (defective), or available for assignment. A 0-bit indicates that the specific RB is 
available for assignment. The standard number of physical record units per record block (PRU/RB) is 
given in the following table: 







Type /Device 




Device 


RMS Type 


Codes 


PRU/RB 


6603-1 


DISK 


AA 01 


** 


6638 


DISK 


AB 02 


50 


6603-11 


DISK 


AC 04 


** 


865 


DRUM 


AD 12 


21 


863 


DRUM 


AE 11 


21 


814 


DISK 


AF 10 


62 


821 


DISK 


AL 05 


320 t 


841 


DISK PACK 


AM 06 


56 


854 


DISK PACK 


AP 07 


4 



INNER ZONE IS 50 PRU/RB 
OUTER ZONE IS 64 PRU/RB 
2 RBRs ARE REQUIRED 
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I = 1 SECTOR 
= 1 PRU 

= 64 (1Q) CM Words 
= 320 (1Q) PP Words 



Half-Track Recording Technique 

Alternate sectors of a physical recording track on 6603 or 6638 disks are numbered consecutively; interven- 
ing sectors are numbered the same way. Essentially, one recording track is divided into two half tracks, one 
containing the odd-numbered sectors, the other even-numbered sectors. The time required to move to the 
next numbered sector is used to set up parameters and load or unload PP memory in preparation for the 
read/write of the next sector. 
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RECORD BLOCK RESERVATION TABLE 

A record block on a mass storage device is allocated to a file before any data can be written to that file. As 
data is written and a record block is filled, another record block must be assigned. Before the stack 
processor can select a record block to assign to a file, it must determine availability of record blocks. A 
record block reservation table maintained in CMR provides this information. 

Each mass storage device is represented by at least one entry in the RBR. Several RBRs can be generated 
for a single device, each describing a unique area on the device. Each entry is made up of a two-word 
header and a variable length bit table. Each bit represents the availability of the corresponding record 
block; if a bit is zero, the RB is available for assignment; if a bit is one, the RB is not available. 

Format of the RBR: 



W.RBRTPA 
W.RBRUNT 










RBR Header Word Pair 










W.RBRLAV 































T.RBRBIT/ 



Any Additional Header Word Pairs 



Bit Table Starting Address Pointed to by Header 



Length 



i 



£ 



Additional Bit Tables 
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The first word of each RBR header contains a 6-bit allocation style code and a default bit; both are 
supplied as parameters to the RBR macro when the CMR is assembled at an installation. Unique allocation 
style codes for each standard RB may be set by the installation; this code can be used to direct a file to the 
RBR with the correct RB size and/or recording technique. If the default bit is set in an RBR header, file 
allocation requests that do not specify allocation style may be assigned to that RBR. 

Standard (default) RB size and RBR bit table length for each mass storage device are found in the table 
given under MASS STORAGE I/O PROCESSING. 



Format of two-word header: 



RECORD BLOCK RESERVATION TABLE 



C.RBRTPA-i 
T.RBR 




53 


47 


r-C.RBRUNT 
41 


35 


23 






1 


W.RBRTPA 
W.RBRUNT 


DT 


' 


PPEST 


DJ 


1 

;t 


Unit 


Starting 
Device Address 


A 




C.RBRAL 

Allocation 

Style 


PRU/RB 


W.RBRLAV 


BTS 


RBR Bit Table 
Starting Address 


C.RBREST 
EST Ordinal 


C.RBRLAV 
Available RB's 


Usable RB's 



DT 

PPEST 

DST 

UNIT 

A 



Device type code 

Family pack EST ordinal (first pack in family) 

DST ordinal 

Unit number 

If one, files without specific allocation style are permitted on the 
device 



BTS 

Alloc. 
Style 



Bit table size divided by two 



Allocation style for this RBR 
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RECORD BLOCK TABLE (RBT) 

The Record Block Table (RBT) is file-oriented. Each mass storage file in the system has an associated RBT 
entry. The RBT, located in the highest address end of central memory, consists of several word pairs, one 
for each file that exists on an allocatable device currently recognized by the system. The RBT expands and 
contracts by 100 octal word blocks as files are allocated and released. A maximum of 8192 (decimal) central 
memory words may be assigned to contain all the RBT entries active at any one time. 

When a mass storage file is established, a two-word RBT entry is created for that file; additional entries are 
assigned and linked in a chain as the file expands and entries are needed. Each entry consists of ten 12-bit 
bytes, some are used as pointers to additional entries in the chain and to other tables. Remaining bytes in 
the entry contain the RB number of a record block assigned to the file. RB numbers are placed in sequential 
RB bytes in order of their assignment. An RB number serves as the address of a bit in the RBR bit table 
representing the availability of that record block; it is also the address of the corresponding physical record 
block on the mass storage device. RBT entries are addressed by RBT word-pair ordinals. The word-pair 
ordinals are numbered sequentially starting from the highest address in central memory. 

The CMR pointer word P.RBT contains the current size of central memory in 100-word blocks, as well as 
the current length of the RBT in 100-word increments. The same word also contains the RBT word pair 
ordinal of the first member of the RBT empty chain. Unused word pairs in the RBT are linked together to 
form the empty chain. As record blocks are released from an evicted file, the dropped word pairs are linked 
to the end of the empty chain. Word pairs are assigned to entering files from the head of the RBT empty 
chain and the new first-member word pair ordinal is entered into the CMR pointer word. 



P.RBT 



Entry 
Ordinal 

1 



16 

24 
26 



32 

n*40 



RBT Empty 
Chain Ord. 



RBT Size 
(n Blocks) 



(8) 



32 



26 



24 



High 
Core 



RBT 



Low 
Core 
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Word 1 of the first word pair (figure 4-2) assigned to a file contains ordinals, flags, etc. The RB bytes (up to 
8 usable in any word pair) denote the record blocks assigned to the file. These bytes, initially zero, are set as 
each record block is assigned. The values in the RB bytes are interpreted as either RB numbers (for RBR 
bit table use) or as physical record block addresses (see figure 4-4). As a file expands, additional RB addresses are 
entered into the RB bytes until the word pair is filled or no more record blocks are assignable from the RBR table. 
In either case, another word pair is assigned to the file and linked to the current word pair. Bytes and 1 in the 
succeeding word pair contain RBT and RBR ordinals. If an overflow occurred, the RBR ordinal is replaced by the 
value of 777. The remaining 8 RB bytes contain assigned record block addressed. 

As a file is evicted or record blocks are dropped, the RB bytes are cleared. When an entire word pair is 
emptied, it is linked to the end of the RBT empty chain. 

RECORD BLOCK TABLE (RBT) ENTRY FORMAT 
First RBT Word Pair: 



59 


47 S.RBTRBR 




35 29 


23 


11 


C.RBTWPL 
Next Word Pair 


C.RBTRBR 

C.RBTFB 

RBR Ordinal 


3 


C.RBTAL 
■ Alloc. 
| Type 


C.RBTPRU 
Last PRU + 1 


C.RBTBIT 
Flags 


RB3 


RB4 


RB5 


RB6 


RB7 



Other Word Pairs: 



59 


47 




35 




23 




1 







C.RBTWPL 
Next Word Pair 


C.RBTRBR 

C.RBTFB 

RBR Ordinal 





RBO 


RB1 




RB2 




RB3 


RB4 


RB5 


RB6 


RB7 



C.RBTBIT 

11 10 98765432 1 



S.RBTDEV — Assigned by device type — ' 
S.RBTEST — Assigned by EST ordinal — 
S.RBTPFD - PF device assigned — 

S.RBTNEW - RBT new — 

S.RBTOVF — Overflow — 

S.RBTRND — Random — 



£ 



(Reserved) 
(Reserved) 
(Reserved) 
(Reserved) 
(Reserved) 
FO = IS or DA (S.RBTSAM) 



Figure 4-2. RBT Entry Format 
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The end of a file's RBT chain is a word pair having zeros in byte of the first word. The last word pair in 
the empty chain contains all zeros. 

The interrelationship of the FNT, RBT and RBR entries for a file assigned to an outer zone half track on a 
6603 RMS disk is illustrated in figure 4-3. Pointers in the lower table area of CMR give the first word 
addresses of the FNT and the RBR area. The RBT size, in 100-word blocks, is multiplied by octal 40 to 
yield the number or word pair ordinals in the RBT. Multiplying any RBT ordinal by 2 and subtracting it 
from the LWA + 1 address of central memory will produce the address of the word pair entry. 

RECORD BLOCK TABLE BYTE 



(Computation of physical addresses for default allocation styles) 
11 10 98765432 1 



6638 



821 



1 1 1 1 1 1 1 I I 1 1 ' 

Track Number 






Z 


1 1 1 1 1 1 
Head Position 


1 
HG 


O/E 




Head Position 


S 


111 
Head Group 


O/E 






000 


O/E 


l l l 1 1 
Head Group 


1 ■ 
SG 




i l i > i i i i 1 1 -■ 
Track Number 








l 1 i i ,' l 

N 




i i i i i 1 1 1 
N 


1 





HG Head Group 

O/E Odd/Even 

S Stack 

SG Subgroup 



=■ Outer 

1 - Inner 



= Even 

1 = Odd 



Cylinder 

Track 

Sector 



N-1 

2 


if N-1 is even 

1 if N-1 is odd 



841 Cylinder 

Track 

Sector 



N-1 
5 

8 * remainder of — r— modulo 20 
5 

N-1 

if remainder of — r— < 2 

5 — 

N-1 

1 if remainder of —^— > 2 

5 



Figure 4-4. Record Block Address Format 
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CMR 



P.RBR 



P.FNT 



FWA FNT 



FWA RBR 



LWA+1 FNT 



RBTSize 



P.RBT 



FNT 



FET -*■ 



FST 



File Name (Ifn) 



FET Address ^ 



V^\ 



\ 



\ Current \ 

U A 



First 
RBTOrd.— * \PR 

Current \ 
RBTOrd.—^ 



RBR Area 



Bit-Table 
Address - 



Bit-Table < 



RBR Table No. 4 Header 



11110 10 0©0 1 



RBT 



FNT/RBT/RBR Interface 
for a Sequential File on a 
6603 RMS Outer Zone 




Figure 4-3. File Table Interfaces 
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When the file is established for a job, an entry is made in the FNT; and a pointer to this entry is placed in 
the job's FET for the file. The FST entry in the FNT for a mass storage file contains the RBT ordinal of the 
first word pair assigned to the file (27 in this example), and the current word pair assigned. It also includes 
the RBT ordinal, RBn byte number representing the current position of the file, and the current PRU 
number in the record block being accessed. In the example, the current RBT ordinal is 52 and the RBn byte 
is RBI (byte 3 in the word). Byte 1 in the first word of any file RBT word pair contains the ordinal of the 
RBR table entry used by the file. The ordinal points to a two-word table header in the RBR area which, in 
turn, points to the bit string for the area on the device to which the file is assigned. 

The current record block in the file is found by using the RB number in the RBn byte of the RBT word pair 
currently being accessed. These RBT pointers are in the FST entry; the example showing word-pair ordinal 
52, byte RBI. Only 3 bits in the FST are needed to point to one of the 8 RB bytes in the RBT word pair. 
The RB number in byte RBI is 5517; when interpreted according to the procedure for finding the corre- 
sponding bit in an RBR bit table, the number points to bit 47 in word 26 of bit table 1 for the device. The 
RB number also is translated into a physical record block address on the 6603. According to the RB address 
format for a 6603 disk, (figure 4-4), the physical record is in the outer zone, head position 151 of head 
group 3, and consists of odd-numbered PRUs. Pointers in the RBT and the FST point to, respectively, the 
PRU currently assigned (last+ 1 ) and the PRU in the record block currently being accessed. 
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SEQUENCER TABLE 



59 



4847 



3635 30 29 24 23 



1211 



1 



T.SEQ 



+1 



A P 

12 



FNT Address 



2 I 



! 



D D D D 







N N 











Interval 



Clock 



^ 



+L.SEQ-1 



FNT Address 



D D D D 







N N 



Interval 



Clock 



JJ = Number of jobs allowed under sequencer (L.SEQ-1 ) 

R R = Number of jobs running under sequencer 

s = Sequencer ON/OFF flag (1 =ON, = OFF) 

DDDD = Diagnostic bits 



BitO = 


CT3 


Bit 1 = 


MY1 


Bit 2 = 


CM6 


Bit 3 = 


CU1 


Bit 4 = 


ALS 


Bit 5 = 


FST 


Bit 6 = 


EC2 


Bit 7 = 


ALX 


Bit 8 = 


(Reserved) 


Bit 9 = 


(Reserved) 


Bit 10 = 


(Reserved) 


Bit 11 = 


(Reserved) 



F = Drop Flag 
NN = Job number (5 bits) 
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P.RMS 







C.RMS 
T.RMS/10 


C.RMSL 
L.RMS 





59 



51 



ROTATING MASS STORAGE DIAGNOSTIC TABLE 

40 29 21 10 



T.RMS/10 



E0 


EOL 


EOU 


E1 


E1L 


E1U 


E2 


E2L 


E2U 


E3 


E3L 


E3U 


E4 


E4L 


E4U 


E5 


E5L 


E5U 


E6 


E6L 


E6U 


E7 


E7L 


E7U 















L.RMS 



EO, E1, E2, etc. — EST ordinal of preallocated RMS device 
EOL, E1L, etc. — Lower cylinder boundary of preallocated area 
EOU, E1U, etc. — Upper cylinder boundary of preallocated area 

INTERCOM TABLE 



S.I1BR - 1BR Dropping — 

S.1 1 1 1 - 111 in Progress — 

S.IEDIT- EDITLIB in Progress — 

S.I1PT- 1PT Drop Bit — 

S.I1CI - 1CI Drop Bit— | 



59 



47 



W.IUSID 
W.ICOM 

W.IENDLS 



C.ITUSID 

Last User I D 

Assigned 



C.ILSFL 
(LWA+D/100B 
of Small Buffers 



C.I1BR 



32 



C.IUPF 



C.IFBUFR 



FWA of First 
Linked Buffer 



£ 



LCCUp-S.INTC 
f— High Speed Up - S.I NTH 
|- Low Speed Up - S.INTL 

(-Lockout of | LCC Dr °P ^9 - S.INTC 

(—High Speed Drop Flag - S.INTH 
r Low Speed Drop Flag - S.INTL 



LOGIN - 

S.ILKOUT 

22 



C.INTDSD 



11 







Stimulator 
Flag 



Multiplexor Subtables 
(OneSubtableperMUX) 
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6671 MULTIPLEXER SUBTABLE 



59 



53 



47 



35 



27 



23 



11 



C.IOTFL 

Count of 

Output Failures 


C.ILSDT 
Count of Lost 
Data Failures 


C.IMPAR 

Count of MUX 

Memory Parity Errors 




C.INPTS 

Number of 

ports serviced 


C.INBUF _. t t . . . 

. First user table in chain 

assigned to this port 




# 


C.IIMSG 


| 


* 


| 










> 




Hard -wired -* 
4800 Baud- 






-BCD 200 UT 
-TTY 
-ANSI 200 UT *£ 



PortO 



Port 1 



Port n 



'Treated as one contiguous field (bits "15" - 0) 
Bits "15" -0 = : dial-up line 

"15" - + : hard-wired: site n exists if bit n 



6676 MULTIPLEXER SUBTABLE 



59 



53 



47 



35 



23 



11 



C.IOTFL 

Count of 

Output Failures 



C.ILSDT 

Count of Lost 

Data Failures 



C.INBUF 



First user table in chain 
assigned to this port 



C.INPTS 

Number of 

Ports Serviced 
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6673/6674 MULTIPLEXER SUBTABLE 



59 



53 



35 



23 



C.INBUF 



First high speed 
user table address 



C.IHID 
First User ID 
Allocated 



C.IHCON 



•S.16673-MUX is 6673 
• S.IGRAPH - Graphics Legal 

■ Port 3 Defined 

■ Port 2 Defined 

■ Port 1 Defined 

■ Port Defined 




11 



Definition of existing 
274 Graphics Consolest 



tWord 2 present if S.IGRAPH = 1 
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INPUT/OUTPUT 



I/O PHILOSOPHY 

Input and output request processing depends upon the source of each request. Active user CM programs 
issue RA+ 1 requests for I/O which are cycled through CPMTR. PP programs request I/O by placing a 
monitor request into their PP output register. System programs, which run at control point N.CP+1, 
cannot make monitor requests through RA + 1 . Since they run as CM service functions for PP programs, 
they make such requests through the output register of the PP servicing the program. 

CPMTR assigns the I/O request to CP.CIO which, in turn, assigns it to the proper processor, CIO or ISP. 
CIO (circular input/output) processes requests for magnetic tape, Teletype, and unit record I/O; and ISP 
(stack processor) processes all requests for mass storage I/O. 




I/O 
Drivers 



Mass Storage 
I/O Drivers 



Another I/O processor, JANUS, exists in SCOPE, but its function is limited to processing unit record I/O 
for the system input and output queues. The queues contain job input and output files and are related to the 
job processing activities of SCOPE. JANUS is discussed under the job processing section of this manual. 
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CIO 

The circular input/output processor consists of the central memory program CP.CIO, the PP program 
OV.CIO and several PP I/O drivers. A system programmer can write his own input/output software, or he 
can have his program generate a call to CIO. Before calling CIO, the program must set up circular buffer 
parameters and the CIO operation code in the file environment table (FET) for the file. The relative address 
of the FET is placed in the CIO call. 

A PP routine places a CIO call in its PP output register; PPMTR passes it through the CP input register for 
the CP.MTR. A CP program places a CIO call in the CP request register (RA+ 1). When PPMTR accepts 
the CIO call, it assigns a PP and clears byte of the PP output register. 

When CP.MTR detects a CIO call, it passes it to CP.CIO for validation and selection of the proper CP.CIO 
routine to supervise execution of the function. The CIO call is then reissued via the request stack and 
CP.MTR to be processed by the required PPCIO driver; byte zero of the RA+ 1 register is cleared. When 
the I/O operation is completed CP.CIO adds one to the code/status field of FET word one. As all CIO 
codes placed in the FET code/status field are even numbers, an odd number in that field signals completion 
of the operation (or that the file is not busy). 

SCOPE CIO CODES (3.4) 

All codes indicated by * are illegal; all reserved codes are illegal. All codes are octal for coded mode 
operations; add 2 for binary mode. Example: 010 is coded READ, 012 is binary READ. 



000 


RPHR 


054 


* 


130 


CLOSE,NR 


004 


WPHR 


060 


UNLOAD 


134 


* 


010 


READ 


064 


* 


140 


OPEN 


014 


WRITE 


070 


* 


144 


OPEN,WRITE 


020 


READSKP 


074 


* 


150 


CLOSE 


024 


WRITER 


100 


OPEN,NR 


154 


* 


030 


* 


104 


OPEN,WRITE NR 


160 


OPEN 


034 


WRITEF 


110 


POSMF 


164 


* 


040 


BKSP 


114 


EVICT 


170 


CLOSE,UNLOAD 


044 


BKSPRU 


120 


OPEN,NR 


174 


CLOSE,RETURN 


050 


REWIND 


124 


* 
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200 Series for Special Read or Write (reverse, skip, non-stop, rewrite, etc.) 



200 


READC 


230 


* 


254 


* 


204 


WRITEC 


234 


REWRITEF 


260 


READN 


210 


READLS 


240 


SKIPF 


264 


WR1TEN 


214 


REWRITE 


244 


* 


270 


* 


220 


* 


250 


READNS 


274 


* 


224 


REWRITER 











300 Series for Tape OPEN and CLOSE 



300 


OPEN.NR 


324 


* 


354 


* 


304 


* 


330 


CLOSER 


360 


* 


310 


* 


334 


* 


364 


* 


314 


* 


340 


OPEN 


370 


CLOSER.UNLOAD 


320 


* 


350 


CLOSER 


374 


* 



400 Series (Reserved for CDC) 

500 Series (Reserved for Installations) 

600 Series 



600 * 

604 * 

610 * 

614 * 
620 

624 * 



630 * 

634 * 

640 SKIPB 

644 * 

650 * 



654 
660 
664 
670 
674 



700 Series (Reserved for CDC) 
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CIRCULAR BUFFER 

A circular buffer is a temporary storage area in central memory through which data passes during I/O 
operations. It is termed circular because I/O processing routines treat the last word and the first word of the 
buffer area as contiguous. 

FIRST is the first word address of the circular buffer. Routines that process I/O never change the 
value of FIRST. 

LIMIT is the last word address + 1 of the buffer area. No data is stored in this word. When LIMIT 
is reached, the next address accessed is FIRST. Routines that process I/O never change the value of 
LIMIT. 

OUT is the next location from which data is removed from the circular buffer. CIO or the calling 
program changes OUT depending on whether the operation is read or write. 

IN is the next location into which data is written. CIO or the calling program changes IN depend- 
ing on whether the operation is read or write. When IN=OUT-l, the buffer is full. A partly filled 
buffer extends from OUT to IN- 1 . 




Space for Data 




LIMIT 



OUT 



LIMIT 



IN 



FIRST 



IN 


Space for Data 


i 
OL 


JT 


////////// Data v//// 


4, 


FIR< 


3T 


Space for Data 
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Circular Buffer 




The circular buffer must be at least one word larger than the length of one PRU. For a write operation, at 
least one PRU of data should be in the buffer. For a read operation, the buffer must have room to receive 
one PRU of data. Less than one PRU may be transmitted only if an end-of-record is read or written. 

CIO OPERATION 

When MTR initiates CP.CIO to perform file I/O, CP.CIO locates the FNT for the file. If the FNT pointer 
in the FET is non-zero, CP.CIO checks the FNT entry indicated by the pointer to determine if the file name 
in the FNT entry is the same as the file name in the FET; it will also check that the file is assigned to the 
job control point. If the names do not match or if the FNT pointer is zero, CP.CIO will search the entire 
FNT for a file assigned to that job control point with a matching name. If the file is not found, CP.CIO will 
create a FNT entry for the file. Such files are always local and assigned to allocatable devices. Once the 
FNT entry is found or created, CP.CIO stores the address of the FNT entry in the FET. The FNT pointer 
in the FET facilitates the FNT search. 

If file status is busy, CP.CIO posts the request for rescheduling and exits. Otherwise, CP.CIO checks the 
code field in the FET against the last code/status field in the FNT to ensure the requested operation can 
legally follow the preceding operation. If not, CP.CIO replaces the RA+ 1 call with a request for the PP 
program CEM which handles error messages, then reissues the RA+1 call to be processed again by 
CP.MTR. If the operation is legal, CP.CIO transfers the code/status field in the FET to the last code/status 
field in the FNT. The proper CP.CIO routine is selected to supervise function execution. 
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When the file is opened, CP.CIO determines if the file is on an allocatable or non-allocatable device or is 
ECS resident by checking the device code in the second word of the FNT. If the file is on an allocatable 
device, CP.CIO puts the request in the I/O request stack in CMR. The stack processor CP.SPM schedules 
I/O on allocatable devices; it will perform the I/O and set the completion bit. OV.CIO and its overlays 
process I/O requests for non-allocatable and ECS buffered files. 

When OV.CIO is required, PPMTR assigns an available PP and causes OV.CIO to be loaded and initial- 
ized. Depending upon the operation, OV.CIO will call one or more of the following overlays. 



Function routines: 



Tape Drivers: 



1CL 

lOP 

IMF 

1RP 

3DO 

4ES 

6WM 



IRS 

1RT 

1MT 

1NR 

1NW 

1WS 

1WI 

1TF 

2TB 

1R9 

1W9 



Unit record drivers: 



2 PC 
2RC 

2 LP 



File close 

File open 

Multifile positioning 

Reel close 

Mass storage device file open 

Enter stack request (mass storage I/O) 

Write error message 



Read 7-track stranger (S) tapes 

Read 7-track SCOPE standard labeled tapes 

Read/write other tapes (7-track) 

Read 9-track stranger (S) tapes 

Write 9-track stranger (S) tapes 

Write 7-track stranger (S) tapes 

Write 7-track SCOPE standard labeled tapes 

Move tape forward (except long record (L) tapes) 

Move tape backward (except long record (L) tapes) 

Read 9-track SCOPE standard labeled tapes 

Write 9-track SCOPE standard labeled tapes 



On line card punch 
On line card reader 
On line printer 



Tape error recovery drivers: 

1 P 1 Write error recovery — tape positioning 

1 P2 Write error recovery — erase/rewrite 

1 P3 Write error recovery — verification driver 

1 P4 Write error recovery — final driver 
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1RV Initialize/terminate read error recovery 

1 R2 Read parity error recovery 

1R3 Read error recovery — reposition/reread 

1NO Noise error recovery — read error processing 

1N2 Noise error recovery — read recovery driver 

1N3 Noise error recovery — skip noise record 

1CS Write CM data — 7/9 track stranger tape read recovery 

1CT Write CM data - 7/9 track SCOPE standard tape read recovery 

1CR Write CM data — 7-track other tape read recovery 

If the file device code is for a non-allocatable device, PPCIO loads an I/O driver into its PP to perform the 
actual I/O. The overlay selected is determined by the operation requested. For example, if a user issues a 
request to read data from a file on a SCOPE standard format 7-track tape, CIO will call the overlay 1RT 
into its PP. 1RT will reserve one of the hardware channels connected to the equipment. It then issues the 
function codes to connect the controller and tape drive. 1 RT issues functions to transmit one PRU of data 
from the tape drive over the data channel. 

1RT accumulates the PRU of data in a PP buffer. When the entire PRU is transmitted or an end-of-record 
(short PRU) is encountered, 1 RT picks up the pointers to the circular buffer in central memory from the 
FET. 1 RT continues to transfer PRUs of data from the tape through the PP buffer to the circular buffer 
until the buffer is full or an end-of-record is encountered. 1RT updates the PRU count in the file FNT, 
releases the channel, sets completion bits in the FNT and FET, and drops out. 

The following charts depict the logical sequence of events during various CIO tape operations. 
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READ 




1 . Exit if not enough room in buffer for one 
maximum size physical record. 

2. Exit if not enough room in buffer for MLRS 
words. 

3. Read one physical record into PP. 

4. Read one physical record into CM. 

5. If physical record exceeds maximum allow- 
able, return error status DEVICE CAPACITY 
EXCEEDED and perform error procedures. 

6. If physical record exceeds maximum logical 
record size, return error status DEVICE 
CAPACITY EXCEEDED and perform error 
procedures. If a long record is encountered, 
excess information is discarded without noti- 
fication to user. 

7. If end-of-file mark was read, perform end- 
of-file mark procedures. 

8. If noise records encountered, go to 3. 

9. If parity error, perform parity procedures. 

10. If end-of -tape reflective spot was encountered 
and tape is unlabeled, perform end-of-reel 
procedures. 

11. If short PRU was read, strip level number. 

12. If zero length PRU was read, go to 21. 

13. When 6681 is present, convert data in PP 
from BCD to display code. 

14. When 6681 is present, convert data in CM 
from External BCD to display code. 

15. Convert 1632 line terminator to 0000. 

16. Transmit data to CM. 

17. Update IN. 
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READ (Continued) 




18. Fetch OUT from CM. 

19. Place in word 7 of FET the number of un- 
used bits in the last data word. 

20. If full PRU, goto 1. 

21. If last record was level 17 of tape mark, set 
end-of-f ile status. 

22. Set end of record in status field of FET and 
exit. 
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READN 



7, 


/// 


'// 


V 



1. 


Fetch size of MLRS from word 7 of FET. 


X 


X 


X 


X 


2. 


Exit if not enough room in circular buffer for one logical 
record plus header word. Buffer size must be > C(record) 












+ 1 (header) to avoid OUT = IN when buffer is full. 


X 


X 


X 


X 


3. 


Read one physical record into PP. 


X 


X 






4. 


Read one physical record into CM. 






X 


X 


5. 


If physical record exceeds maximum allowable, return error 
status DEVICE CAPACITY EXCEEDED and perform error 












procedures. 


X 


X 






6. 


If logical record exceeds MLRS, return error status DEVICE 












CAPACITY EXCEEDED and perform error procedures. 






X 


X 


7. 


If end-of-file (tape mark) was read, perform end-of-file 












mark procedures. Go to 18. 


X 


X 


X 


X 


8. 


If noise records encountered, go to 3. 


X 


X 


X 


X 


9. 


If parity error, perform parity procedures. 


X 


X 


X 


X 


10. 


If end-of-tape reflective spot was encountered on unlabeled 












tape, perform end-of-reel procedures. 


X 


X 


X 


X 


11. 


When 6681 is present, convert data in PP from BCD to 
display code. 




X 






12. 


When 6681 is present, convert data in CM from BCD to 
display code. 








X 


13. 


Transmit data to CM. 


X 


X 






14. 


Update IN in PP memory. 


X 


X 


X 


X 


15. 


Place in buffer header word, length of record and number 












of unused bits in last data word. 


X 


X 


X 


X 


16. 


Update IN. 


X 


X 


X 


X 


17. 


Fetch OUT. 


X 


X 


X 


X 


18. 


If last record was tape mark, set end-of-file status and exit. 


X 


X 


X 


X 


19. 


Go to 2. 


X 


X 


X 


X 
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READSKP 



/ 







1 . Read one physical record into PP. 

2. If physical record exceeds maximum allow- 
able (512 CM words, etc), return error status 
DEVICE CAPACITY EXCEEDED and per- 
form error procedures. 

3. Read one physical record directly from 
tape to CM buffer, stopping without error 
when available buffer space is full. 

4. If end-of-file (tape mark) was read, perform 
end-of-file mark procedures. 

5. If noise records encountered, go to 1 . 

6. If parity error, perform parity procedures. 

7. If end-of-tape reflective spot is encountered 
on unlabeled tape, perform end-of-reel pro- 
cedures. 

8. If short PRU was read, strip level number. 

9. If zero length PRU was read, go to 10. 

10. When 6681 present, convert data in PP from 
BCD to display code. 

11. When 6681 present, convert data in CM from 
BCD to display code. 

12. Convert 1632 line terminator to 0000. 

13. Transmit data to CM. If record exceeds 
circular buffer, stop without error at buffer 
full. 

14. Place number of unused bits in last data word 
in word 7 of FET. 

15. Update IN. 

16. Fetch OUT from CM. 

17. If any unused space in circular buffer, go to 1. 
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READSKP (Continued) 



VtMtU/fU/i/ 



18. If last record was full PRU, set n = 1 and 
proceed to SKIPF. 

19. If L is less than 17, set L = 0. 

20. If record was end of file mark (tape mark), 
assume level = 17. 

21. If level number is less than 1, set n = 1 and 
proceed to SKIPF. 

22. If level number is less than L, set n = 1 and 
skip to first end-of-file mark (tape mark). 

23. If last record was level 17, set end-of-file 
status and exit. 

24. If last record was not level 17, return end- 
of-record status and exit. 
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RPHR 






1. Set OUT = IN. 

2. Exit if not enough room in buffer for one maximum size physical record. 

3. Read one physical record into PP. 

4. If physical record exceeds maximum allowable, return error status DEVICE 
CAPACITY EXCEEDED and perform error procedures. If a long record is 
encountered, excess information is discarded without notification to user. 

5. If end-of-file mark was read, perform end-of-file mark procedures. 

6. If noise records encountered, go to 3. 

7. If parity error, perform parity procedures. 

8. If zero length PRU was read, go to 13. 

9. Transmit data to CM. 

10. Update IN. 

11. If last record was level 1 7 or tape mark, set end-of-file status. 

12. Exit. 
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WRITE 



/ 



///// 




1. Exit if not full PRU. 

2. If data from OUT to IN exceeds maximum 
logical record size from FET, return DEVICE 
CAPACITY EXCEEDED and perform error 
procedures. 

3. Fetch number of unused bits in last data 
word from FET and adjust record length. If 
record length constitutes a noise record, 
return DEVICE CAPACITY EXCEEDED and 
perform error procedures. 

4. Read one PRU of data starting at OUT from 
CM to PP. 

5. Read data contained between OUT and IN 
from CM to PP. Adjust by unused bit count. 

6. When 6681 present, convert display code to 
BCD in PP memory. 

7. When 6681 present, convert from display 
code to BCD in CM. 

8. Convert zero byte line terminator to 1632. 

9. Write record to tape. 

10. Write, from CM to tape, data contained be- 
tween OUT and IN, adjusted by unused bit 
count. 

1 1 . When 6681 present, convert data in CM buf- 
fer back to display code. 

12. If parity error, perform parity procedures. 

13. If end-of-tape reflective spot, perform end- 
of-reel procedures. 

14. Update OUT. 

15. Exit. 

16. Fetch IN from CM. 

17. Gotol. 
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WRITER 



///fr 




1. If IN = OUT, exit. 

2. If PRU not full, insert level number in PP 
buffer. 

3. If data from OUT to IN exceeds maximum 
logical record size from FET, return DEVICE 
CAPACITY EXCEEDED and perform error 
procedures. 

4. Fetch number of unused bits in last data 
word from FET and adjust record length. 
If record length constitutes a noise record, 
return DEVICE CAPACITY EXCEEDED 
and perform error procedures. 

5. Read one PRU starting at OUT or between 
OUT and IN, whichever is smaller, from CM 
to PP. 

6. Read data between OUT and IN from CM 
to PP. Adjust by unused bit count. 

7. When 6681 is present, convert display code 
to BCD in PP memory. 

8. When 6681 is present, convert display code 
to BCD in CM. 

9. Convert zero byte line terminator to 1632. 

10. If IN = OUT, write zero length record. Go 
to 12. 

1 1 . Write record to tape. 

12. Write data between OUT and IN from CM to 
tape, adjust by unused bit count. 

13. When 6681 is present, convert data in CM 
buffer to display code. 

14. If parity error, perform parity procedure. 

15. If end-of-tape reflective spot, perform end- 
of-reel procedures. 

16. Update OUT. 

17. Exit. 

18. If full PRU is not written, exit. 

19. Gotol. 
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WRITEF 




.////> 



<b / O 



1. If no data from OUT to IN, go to 23. 

2. If no data from OUT to IN, go to 19. 

3. If not full PRU, insert level number. 

4. If data from OUT to IN exceeds maximum 
logical record size, return DEVICE CAPA- 
CITY EXCEEDED and perform error pro- 
cedures. 

5. Fetch number of unused bits in last data 
word from FET and adjust record length. 
If record length constitutes a noise record, 
return DEVICE CAPACITY EXCEEDED 
and perform error procedures. 

6. Fetch one PRU of data starting at OUT or 
data between OUT and IN, whichever is 
smaller, from CM to PP. 

7. Read data contained between OUT and IN 
from CM to PP. Adjust by unused bit count. 

8. When 6681 is present, convert display code 
to BCD in PP memory. 

9. When 6681 is present, convert display code 
to BCD in CM. 

10. Convert zero byte line terminator to 1632. 

1 1 . Write record to tape. 

12. Write data between OUT and IN from CM to 
tape, adjust by unused bit count. 

13. When 6681 is present, convert data in CM 
buffer to display code. 

14. If parity error, perform parity procedures. 

15. If end-of-tape reflective spot, perform end- 
of-reel procedures. 

16. Update OUT. 
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WRITEF (Continued) 




17. Write end-of-file mark and exit. 

18. If full PRU is not written, write zero length 
level 17 record and exit. 

19. Go to 3. 

20. If last operation was WRITE, write zero 
length PRU. 

21. Goto 17. 
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WRITEN 




1. If OUT = IN, exit. 

2. Fetch header word from OUT. Set PPOUT = OUT + 1. 
Set PPIN = PPOUT + number of CM words in logical record. 
If PPIN has passed IN, exit. 

3. If data from PPOUT to PPIN exceeds maximum physical 
record size, return DEVICE CAPACITY EXCEEDED and 
perform error procedures. 

4. Adjust record length by number of unused bits in last data 
word (from header word). If noise record, return DEVICE 
CAPACITY EXCEEDED and perform error procedures. 

5. Fetch data contained between PPOUT and PPIN. Adjust 
by unused bit count. 

6. When 6681 is present, convert display code to BCD in PP 
memory. 

7. When 6681 is present, convert display code to BCD in CM. 

8. Write record to tape. 

9. Write data between OUT and IN from CM to tape, adjust 
by unused bit. 

10. When 6681 is present, convert data in CM buffer back to 
display code. 

11. If parity error, perform parity procedures. 

12. If end-of-tape reflective spot, perform end-of-reel pro- 
cedures. 

13. Update PPOUT. 

14. UpdateOUT. Fetch IN. Gotol. 
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WPHR 



/ 



/ 



<//// 



1. If IN = OUT, exit. 

2. If more than 512 words in buffer, return DEVICE CAPACITY EXCEEDED to 
FET. 

3. Fetch data from OUT to IN, or 512 words from OUT, whichever is smaller. 

4. Write record to tape. 

5. If parity error, perform parity procedures. 

6. If end-of-tape reflective spot, perform end-of-reel procedures. 

7. Update OUT and exit. 
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SKIPF 

1. If n = 0, set n = 1. 

2. If L is less than 17, interpret as L equals 0. 

3. Read a physical record. 

4. If noise record encountered, go to 3. 

5. If end-of-tape reflective spot encountered 
on unlabeled tape, perform end-of-reel pro- 
cedures. 

6. If record is full PRU, go to 3. 

7. If end-of-f ile mark encountered on unlabeled 
tape, assume level number equals 17. 

8. If record is not end-of-file mark, assume 
level number equals 0. 

9. If end-of-file mark encountered on labeled 
tape, perform end-of-file procedures. 

10. If level number is less than L, go to 3. 

1 1 . Subtract 1 from n. If n ¥= 0, go to 3. 

12. Return end of record to status. If last level 
number was 17, return end of file to status. 
Exit. 



J 



/ 



f*/J*/J 






& & 
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SKIPB 

1. If n = 0, set n = 1. 

2. If L is less than 17, interpret as L equals 0. 

3. If reel is at beginning of data (either physi- 
cal load point or zero physical record count), 
set beginning of information and exit. 

4. Read one physical record backward. 

5. If noise record encountered, go to 4. 

6. If record was full PRU, go to 3. 

7. If this is first read backward, go to 3. 

8. Position forward over short PRU. 

9. If end-of-file mark encountered, assume 
level number = 17. Otherwise, assume level 
number = 0. 

10. If level number is less than L, go to 3. 

11. Subtract 1 from n. If n is not equal to zero, 
go to 3. 

12. Exit. 



J 



f 



////#// 
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BSKP 

The BKSP function is identical to SKIPB with 
n = 1 and L = 0. 



BKSPRU 



1 . If at load point or PRU count = 0, set begin- 
ning of information in FET and exit. 

2. Backspace one physical record. 

3. Subtract 1 from n. If n not equal to 0, go to 
1. 

4. Exit. 



S//& 
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ALLOCATABLE DEVICE I/O 

Most files in the system are stored on allocatable units. The system library ZZZZZ04 is stored on an 
allocatable unit known as the system device. Each time a non-resident CP program or a PP overlay is to be 
loaded from that library, I/O must be performed on the system device. The job and system dayfiles and the 
CE error files are stored on allocatable units, as are all input and output queue files and all files created by 
CIO. 

A request for I/O on a mass storage allocatable unit must be placed in a table, called the request stack. The 
stack is searched, and the request which will require the minimum amount of overhead to access the data is 
chosen. Overhead involves switching head groups on the disk or physically moving heads. By using a 
priority-incrementing scheme for scheduling disk I/O, overhead is kept to a minimum. 

All mass storage units are connected to controllers which are connected to hardware channels of the 
computer. For some disk devices, the controller and the disk unit form one piece of equipment. In most 
cases, however, the controller and the disk are physically separate units. All mass storage units connected to 
a single controller must be of the same type. 

READC 

The READC function is intended primarily for system use with mass storage files. Since READC uses 
inter-sector time to the maximum while reading high-speed mass storage devices, it does not include checks 
for erroneous programming and control words. READC would only be used by system programmers. 

READC lfn.recall 

READC transmits PRU's continuously to the circular buffer, with a control word preceding each PRU. 
READC is a function applicable to all mass storage devices. Reading continues until: 

Buffer does not have enough room for the next PRU and its control word. 

An error condition occurs. 

End-of-information is encountered. 

Code and status on completion; where x depends on file mode: 

00020X Normal completion 

03380X Error code 33 

74123X EOI 

On mass storage, the same amount of data is transmitted for every PRU: the control word and one device 
standard PRU. The last 12 bits of the control word and the entire standard PRU length are exactly the 
physical data recorded on the device, including system control information. 
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Format of the PRU is shown below. 



59 


53 


47 


35 




29 


23 







PRU size 




UBC 


BYTE count 


Good Data 


iev 


Invalid Data 



PRU size 
UBC 
Byte count 



lev 



Number of central memory words in each PRU on the device 

Unused bit count; always 

Count of the number of 12-bit bytes of data. It must be equal to 5 
times the number of central memory words occupied by the data. 
The value is recorded on disk as 12 bits, but expanded here to 24 
bits. 

SCOPE logical record level number. If the byte count divided by 5 
is less than the PRU size, a short PRU is involved. 



The READC macro generates the following code: 
59 47 40 



29 



17 



SA1 


Ifn 


RJ 


CPC 


000003 





r 




000200 



READLS 



The READLS function is applicable only to mass storage files. READLS reads several random records into 
the file circular buffer according to the list of direct access addresses provided by the user. No information 
in the buffer will reveal boundaries. This function should be used by system programmers only. 

READLS Ifn, recall 
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Before READLS is called, bits 0-17 of the ninth word of the FET should be set to the address of the list of 
addresses to be read. Since this field is the OWNCODE error exit field under other circumstances, the EP 
bit (bit 44 of the second word of the FET) should be set to 0. 

Reading continues until: 

List of addresses is exhausted. 

End-of-information is encountered while reading a record. 

The buffer is full. 

An error condition occurs. 

The request is discountinued for device repositioning. 

Code and status on completion, where x depends on file mode: 

lv022x Request terminated on end-of- record level lv 

0002 lx Request terminated in middle of logical record 

74023x End-of-file encountered 

74123x End-of-information encountered 

0ee2 lx Error code ee occurred 

The address pointer is updated by the system when a READLS terminates so that the function can be 
reissued by the user without the user changing the pointer. The updated pointer will reflect the next record 
to be read. If reading stopped in the middle of a record, the pointer will reflect the next position to be read. 

The words in the list of addresses to be read can have one of two formats, but the format of the entire list 
must be the same. A word of all zeros must terminate the list. 

Bits 36-59 contain a PRU number, the same as used in SCOPE indexes. These are the numbers the 
system returns to the record request/return information field (bits 0-29 of word 7) of the FET 
when records are written on a mass storage device. Bits 0-35 are zero. A user list in this format will 
be converted by the system to the next format. 

Bits 0-35 contain the SCOPE internal direct access address (RBTA/RBB/PRU) address RBT. 

The READLS macro generates the following code: 



59 


47 






40 


29 


17 


SA1 


Ifn 


RJ 


CPC 


000003 





r 




000210 
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CONTINUOUS WRITE (WRITEC) 

The WRITEC function is intended primarily for system use. Since it uses inter-sector time to the maximum 
on high speed mass storage devices, it does not include checks for erroneous programming and control 
words. 

WRITEC lfn,recall 

WRITEC transmits PRU's from the circular buffer to a mass storage device. Each PRU in the buffer must 
be preceded by a control word. Writing continues until: 

Buffer is empty 

An error occurs 

The diagram of the PRU and control word appears with the discussion of READC. Let n be the device 
PRU size. W must always be n. The 24 low-order bits of the control word and the n full CM words are 
written to the device. 

On all SCOPE-type files, BC must be a multiple of 5. If BC is less than 5n, the high order 12 bits of the 
next CM word after the good data must be a binary level number, which constitutes the end-of-logical- 
record. The level number range is < level < 17 octal. 

Level 17B: this is logical-end-of-file. If the file has any data at all, it must be terminated by some end-of- 
logical-record; the level 17 octal must appear as a zero-length logical record. 

W is the count of CM words occupied in the user's buffer; must be device PRU size for mass storage, if not, 
serious errors will result. 

BC is the count in 12-bit bytes of good data in this PRU and must be a multiple of 5. If BC/5 is less than 
device PRU size, then the next 12-bit byte after the good data is the SCOPE level number in binary. L must 
be in the range < 1 < 17 octal. 

The unused bit count field (UBC) in the header word represents the number of unused bits in the last data 
word of a PRU. Since mass storage files are in SCOPE logical record format, data resolution is to the 
nearest full CM word so that the UBC field will always be zero. This field is reserved for future expansion. 

The WRITEC macro generates the following code: 



59 




47 






40 


29 




17 





SA1 


Ifn 


RJ 


CPC 


000003 





r 




000204 
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STACK PROCESSOR 

The Stack Processor consists of the CM resident manager CP.SPM, the PP program ISP and its various 
overlays. Basically, the components of the Stack Processor and their functions are: 

CP.SPM The Stack Processor Manager 

OV.1S5 Examines DST ordinal and loads ISP 

OV.1SP The Stack Processor driver supervisor 

OV.1RN Requests/releases mass storage; releases used chains to the empty 

chain 

OV.3DO Assigns an RB to a new or overflowing file 

CP.SPM is called to enter, terminate and reissue stack requests. Setting and clearing of RBR bits and 
execution of the EVICT function are done by CP.SPM rather than by ISP since device access is not 
required. CP.SPM is activated by an M.ICE request with a value of EX.SPM, placed in T.CPOR by 
PPMTR. The stack request itself is placed into the output register W.PPOR of the PP communications area 
(T.PPCi) of the PP making the request for CP.SPM. Consequently, CP.SPM searches for an empty stack 
request entry, copies the stack request from T.PPCi into the empty entry, inserts the stack request ordinal, 
then adds the stack request entry to the DST chain for 1S5. 

PPMTR loads the basic transient program ISP into a PP by using the stack processor loader, 1S5, which is 
assigned to the same PP into which ISP is to be loaded. PPMTR also sets the active flag in the DST and 
places the DST ordinal into byte 4 of the PP input register for 1S5. When ISP is loaded, it checks the same 
PP input register and references the DST entry to determine the name of the driver overlay to be loaded. 
Driver overlay 3SX will be loaded; x is a display code letter in word 1 bits 42—47 of the DST entry. The 
DST entry also contains channel and equipment numbers for this device. ISP executes all requests in the 
stack for the equipments on the controller; all such requests have been linked into a chain by the stack 
processor manager, CP.SPM. ISP assigns itself to different control points as necessary, always returning to 
control point zero whenever a request is completed or reissued to the stack. 

The code for each driver is contained in a common deck in the program library file. The common deck and 
driver overlay names are listed below: 

Device Type 

6603-1 disk 
6638 disk 
865 drum 
854 disk pack 
6603-11 disk 
814 disk 
821 disk 
841 disk pack 



Common Deck 


ISP Overlay 


RMSA 


3SP 


RMSB 


3SQ 


RMSD 


3SR 


RMSP 


3SS 


RMSC 


3ST 


RMSF 


3SU 


RMSL 


3SV 


RMSM 


3SW 
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59 



NO FNT*- 



FIRST 
WORD 

DIRECT - 



FNT- 



C.STPRBA 
RBT address 



RB number 



0000 



47 



38 35 



C.STPRBN 
RBT index 



RB 
byte 



EST ordinal 



FST Address 



C.STPPRU 

PRU number 



0000 



23 21 17 



C.STO 



11 



DB Rec. 
evel 



suffer in FL — ' 



Don't check bi 
1 = direct access for reading/ 
writing M.S. label 



Order 
code 



C.STCPU 



CTL. 
PT. 



Request 
stack 
chain link 



t 



(Reserved) 



C.STPWC 



C.STPMS 



C.STPFW 



C.STFB 



C.STPLW 



PP 

SECOND 
WORD 

CM 



Y 



t 



PP message 
byte address 



FWAof FETor 
reply word address 



Reply word = 1 
FET =0 



FWA in PP core 



FWA in CM or 
count for skips 



1 = High priority — ' 



I 



LWA in PP core 



LWA+2 in CM 



1 = File has ECS buffer 

Exact (don't read ahead) 

1 =No FET 

1 = No FNT 

Release (read or skip) or 

write EOF 



THIRD 
WORD 



(Supplied by SPM) 



EOI PRU 


FST address 


First RB number 
of RBR 


PRU/RBof 
this RBR 


RBR number 


Unit 



Figure 5-1 . Request Stack Entry Formats 
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The stack processor completes its function, releases its PP, and zeros the active flag in its DST entry when 
all the following conditions are satisfied. 

1. DST entry pointer to start of chain equals pointer to end of chain; no requests in the stack references 
this DST entry. 

2. PP Job Queue entry count (maintained by MTR in byte of CM word T.MSC) is non-zero; at least one 
task is waiting for an available PP. 

3. Active flags are non-zero in at least two DST entries; at least one other ISP is either running in a PP or 
waiting to be assigned to a PP. 

The first two conditions minimize unnecessary dropping-out and reloading of the stack processor; the third 
condition, together with suitable provisions in MTR, ensures that at least one PP contains a stack processor 
at all times, or one PP is reserved for that purpose. This requirement is necessary so it is always possible to 
load a PP overlay that resides on mass storage. 

The format of the request stack entries is given in figure 5-1. 

STACK PROCESSOR ORDER CODES 

Order codes used in mass storage I/O request stack entries differ from those used in the CIO code/status 
fields of FET and FST entries. The three groups of codes correspond to the formats for the second word of 
a request stack entry. Order codes and standard system symbols are given below: 

Central Memory Read/Write Orders 

00 O.READ Corresponds to READ macro, CIO codes 010 and 012. Read data from device to CM 

until (a) end of information is reached, (b) a short PRU is read, or (c) next PRU will 
not fit into the buffer. 



01 O.RDSK 



02 O.RCMPR 



Corresponds to READSKP macro, CIO codes 020 and 022. Read as for O.READ until 
(a) or (b) above, or (c) the CM buffer is completely full; then change to O.SKF with N 
= 1 unless reading was stopped by (b) with record level > request level. 

No corresponding CPC macro or CIO code. Read as for O.READ but do not transmit 
first three CM words of first PRU. Used for loading programs from a system library in 
which first three CM words of each record contain information of interest only to 

EDITLIB and deadstart. 



06 O.RMR No corresponding CPC macro or CIO code. Read several records for which disk ad- 

dresses are given in a table; pointer to table is in FET+ 8. Address of table must be in 
the user's field length. Read records until EOR is reached, buffer capacity is exceeded, 
or the addresses are exhausted. 

03 O.RDNS Corresponds to the READNS macro, CIO codes 250 and 252. Read data from device 

into CM buffer until (a) end of information is reached, (b) a short PRU with record 
level 16 or 17 has been read, or (c) next PRU will not fit into CM buffer. Used by 
loader when reading a relocatable binary field, since it does not stop at an ordinary 
end of logical record. 
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24 O.WCTNU Corresponds to WRITEN macro, CIO codes 264 and 266. Provides non-stop writing 
O.WCTU of tapes without releasing/reloading PP between records. User's buffer must contain at 

least two records. Writing stops when buffer is empty or at end-of-reel condition. 



20 O.RCTNU 
O.RCTU 



04 O.WRT 



05 O.WRTR 



Corresponds to READN macro, CIO codes 260 and 262. Provides non-stop reading 
from tapes without releasing/reloading PP between logical records. User's buffer must 
provide space for at least two records and their header words. 

Corresponds to WRITE macro, CIO codes 014 and 016. Write data from CM to device 
until CM buffer contains less than a full PRU. 

Corresponds to WRITER macro, CIO codes 024 and 026. Write data from CM until 
CM buffer is empty, ending with short PRU (zero-length if necessary) with level 
number specified in request. If EOF flag bit is set, corresponds to WRITEF system 
macro, CIO codes 034 and 036. Same as above, but short PRU is followed by zero- 
length level 17 record (logical end of file mark). 



Peripheral Processor Read/Write Orders 



10 O.RDP 

1 1 O.RDPNP 

14 O.WRP 

15 O.WRPR 
Positioning Orders 

12 O.SKF 

13 O.SKB 



16 O.BPRU 



Same as O.READ, except read data from device into requesting PP's memory. 

Same as O.RCMPR, except read data from device into requesting PP's memory. Used 
for loading mass storage resident PP programs and overlays. 

Same as O.WRT, except write data from requesting PP's memory to device. 

Same as O.WRTR, except write data from requesting PP's memory to device. 



Corresponds to SKIPF macro, CIO codes 240 and 242. Skip forward until N short 
PRU's with level > the level specified in the request have been read, or end of infor- 
mation is reached. With N = 777777, the file is positioned at end of information. 

Corresponds to SKIPB macro, CIO codes 640 and 642. Skip backward one or more 
PRUs until N short PRUs with level > the level specified in the request have been 
read, then move forward over the last of these. With N = 777777, the file is posi- 
tioned at beginning of information (rewound). 

Corresponds to the BKSPRU macro, CIO codes 044 and 046. Skip backward N PRUs. 
This repositioning is by physical record units rather than logical records. 



17 O.RCHN Release allocatable storage and RBTs (processed by SPM). 
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The following table is a summary of stack processor orders: 



Octal 
Code 

00 
01 
02 
03 
04 
05 
06 
07 
10 
11 
12 
13 
14 
15 
16 
17 
20 

24 



System 
Symbol 

O.READ 

O.RDSK 

O.RCMPR 

O.RDNS 

O.WRT 

O.WRTR 

O.RMR 

O.RDP 

O.RDPNP 

O.SKF 

O.SKB 

O.WRP 

O.WRPR 

O.BPRU 

O.RCHN 

O.RCTNU 

O.RCTU 

O.WCTNU 

O.WCTU 



Order 
Function 

Read into central memory 

Read-skip into central memory 

Read into central memory, drop first 3 CM words 

Read nonstop 

Write from central memory 

Write EOF/EOR from central memory 

Read multiple records to central memory 

Not currently defined 

Read into PPU memory 

Read into PPU, drop first 3 CM words 

Skip forward 

Skip backward 

Write from PPU memory 

Write EOF/EOR from PPU memory 

Backspace n PRUs 

Evict 

Read nonstop (comparable to tape READN) 

Write nonstop (comparable to tape WRITEN) 



STACK PROCESSOR/SYSTEM INTERFACE 

The system tables, system routines, and MTR functions used by the stack processor are described in this 
section. 



TABLES 

Control Point Areas: Control point error flag, storage move flag, RA, and FL. The stack processor 
accesses but never changes these fields. 

DST: All fields of the DST entry whose ordinal is placed by MTR in the 1S5 input register are used. 
MTR changes the first word, and ISP changes the second word. In other entries, only the active flag is 
checked. 

EST: Mass storage flag, unloaded flag, off flag, and DST ordinal are checked but not altered. 

FET: Code and status field in first word, error processing flag in second word, and IN and OUT pointers 
in third and fourth words are accessed. Code and status is marked busy (even value) before a request enters 
the stack and is marked complete (off value) when the request is executed. 

FST: RBT/RB/PRU position pointers in first word, code and status field in second word are accessed. 
The code/status field has been processed the same as for the FET. 
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RBR area: All the first header word, the EST ordinal, and available RB count bytes in the second header 
word are used. ISP assigns record blocks for a write request by searching the RBR table for available bits. 
When the request is terminated or re-issued, SPM sets the corresponding bits in the RBR for all record 
blocks assigned for the write operation. SPM also clears RBR bits when record blocks are released and 
updates the available RB count. 

RBT: All fields. The pseudo channel CH.RBT is reserved only when RBT word pairs are being removed 
from the RBT empty chain. 

R.CPRA and R.CPFL (PP Resident): CM reference address and field length, in 100-word block incre- 
ments, for the control point to which ISP is currently attached. 

R.STBMSK (PP Resident): Contains appropriate mask when calling R.STB; always returned to 7700 
octal, its normal value. 

T.MSC (CM Resident): PP job queue entry count is looked at but not changed by stack processor. 

SYSTEM ROUTINES/PROGRAMS 

PP Programs 

1SX Stack Processor Auxiliary program is called by MTR request for tasks that ISP cannot 

handle or does not have time to do. For example, ISP does not issue dayfile messages, 
because if the dayfile buffer is full, ISP and MTR would loop endlessly waiting for 
each other. 

MTR System Monitor calls ISP initially (via 1S5) when a request has been made for an 

inactive DST entry and performs various functions for ISP while it is processing the 
request. 

PP Resident Routines: 

R-DCH Releases a channel reservation. 

R.IDLE Entered when ISP releases its PP. 

RMTR Used for all MTR functions other than reserve or drop channel. 

R.TAFL Terminates access to the control point field lenght. When necessary, it is used to inter- 

lock storage moves during execution of a request, and when a request is terminating 
(except at control point zero) to switch ISP back to control point zero. 

R.OVL Loads driver overlay 3SX. 

R-RCH Reserves a channel. 

RSTB Inserts controller equipment number into device function codes and channel number 

into I/O instructions. 

RTFL Computes an absolute CM address from one that is relative to a control point's RA, 

and checks whether or not a relative CM address is within the control point's FL. 
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Monitor Functions: 

M.DPP Releases PP assignment. 

M.ICE Used by the ECS driver overlay 3SX to initiate CP.ECOVL and by ISP to initiate 

stack processor manager (CP.SPM). 

M.RCH Used (rather than R.RCH) with zero in byte 4 to reserve pseudo channel CH.RBT only 

if it is immediately available. 

M.RPJ Used for calling 1SX to another PP. 

M.KILL Used when a bad monitor request has been made. 

STACK PROCESSOR ERROR CONDITIONS 

This section describes the error conditions that can be detected by the stack processor. In some cases, the 
action depends on debug mode. With IP.DEBUG = 0, these conditions are treated similarly to other errors: 
an error code is placed in the code and status field of FET and FST entries and the control point is aborted 
if error processing (EP) bit in FET is zero. With IP.DEBUG ^ 0, an invalid MTR function is issued with 
the ISP output register having 77 in byte and an error code in byte 1. 

END OF INFORMATION 

Puts 01 into bits 9-13 of code/status, but does not issue a message or abort control point. (Non-fatal 
condition.) 

PARITY ERROR 

A parity error is reported when any possibly recoverable device error occurs during a read or write 
operation. These include actual parity error, lost data, mispositioning, and dropping out of ready status 
during data transmission. The PRU is reread or rewritten up to 62 attempts. (3 for ECS). Whether success 
is attained or not, request execution continues after setting a flag. When request execution is completed, or 
the request is about to be reissued to the stack, the flag is examined. If the error was recovered, 1SX is 
called with code 03 (dayfile message RECOVERED PARITY ERROR), but this condition does not affect 
code/status or abort the control point. If all 62 attempts had failed, 1SX is called with code 04 (dayfile 
message UNCORRECTABLE PARITY ERROR), 04 is put into bits 9-13 of code/status, and control point 
is aborted if EP bit is zero. A request at control point is not aborted. 

INVALID RBR NUMBER 

This error occurs when a request is processed that references an RBT containing an RBR number greater 
than N.RBR-1. In debug mode, issues bad MTR request (77,05). Otherwise, calls 1SX with code 05 (dayfile 
message NON-EXISTENT RBR REQUESTED), puts 05 into bits 9-13 of code/status, and aborts control 
point if EP bit is zero. 
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BUFFER PARAMETER ERROR 

This error occurs when a request is processed that references an FET when not all the following conditions 
are satisfied: 

< FIRST < LIMIT < field length 
FIRST < IN < LIMIT 
FIRST < OUT < LIMIT 

Calls 1SX with code 1 1 (dayfile message BUFFER ARGUMENT ERROR), puts 22 into bits 9-13 of code/ 
status, and aborts control point if EP bit is zero. 

NOT ASSEMBLED FOR ECS 

This error occurs when a request references a DST entry for an ECS device. ISP issues a bad MTR reauest 
(code 77). M 

UNDEFINED ORDER CODE 

A request contains order code 07. Calls 1SX with code 22 (dayfile message INVALID STACK ENTRY), 
puts 22 into bits 9-13 of code/status and aborts control point if EP bit is zero. 

NO FET FOR O.RMR 

A request contains order code 06 (O.RMR), but no FET was specified. Calls 1SX with code 1 1 (dayfile 
message BUFFER ARGUMENT ERROR), puts 22 into bits 9-13 of code/status and aborts control point if 
EP bit is zero. 

CONNECT REJECT 

A request references an I/O unit that cannot be connected or is not ready. If the control point error flag is 
zero, calls 1SX with code 73 (display REJECT - ee STATUS xxxx yyyy) and reissues the request with 
bypass count set to 3. Otherwise, terminates the request with no message. Does not apply to 6603 or 6638. 

Address out of FL for O.RMR: address for table of disk addresses for O.RMR is out of field length Call 
1SX with code 22 (dayfile message INVALID STACK ENTRY), puts 22 into bits 9-13 of code/status and 
aborts control point if the EP bit is zero. 

ECS-BUFFERED I/O 

Reading and writing of RMS files is greatly enhanced by the use of ECS buffers. Such operations involve 
the user of a small CM buffer in the user's field length, a large user's buffer in ECS, and a double buffer in 
CM for system use. The folllowing describes a write sequence involving an ECS buffer; a read sequence is 
essentially the reverse. 
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The user requests ECS buffering on a file-by-file basis through the REQUEST control card or REQUEST 
macro. It should be noted that an installation option will automatically assign an ECS buffer for RMS file 
I/O. On the control card, the user includes an EC parameter in addition to the normal parameters. The 
parameter is written either as: 



EC 



for a default (IP.BUF) size buffer; or, 



EC(xxxx) 
EC(xxxxK) 



EC(xxxxP) 



for a buffer of xxxx-thousand (8) words (K means 1000 and if 
omitted, and P is not specified, is assumed); or, 

for a buffer of xxxx(8) pages. 



In the REQUEST macro, the user must set bit 33 to one in the second word of the parameter list and in the 
fourth word of the parameter list, set the buffer size into bits 0- 1 1 and either the display code character K 
or P into bits 12-17. 

In a write sequence, the user first puts data into his CM buffer, which needs to be only about 2000 words 
long, then issues a CIO call through RA+ 1. If he codes an XJ instruction after placing the request in 
RA+ 1, he will be exchange-jumped out of execution and CP.MTR will be started up to process the request. 

CP.MTR recognizes the CIO call and passes it to CP.CIO for processing. For unbuffered files, the request is 
passed to the PP program CIO for processing. ECS-buffered file I/O will cause CP.CIO to perform a 
validity check on the FET and cause the proper CM-resident ECS driver to be activated. The data is then 
written directly from the user's CM buffer to his buffer in ECS. 

The above process continues until the user's ECS buffer is full, at which time a stack request is generated by 
CP.CIO, requesting that the ECS buffer be written to an RMS device. When the stack request is processed 
by the stack processor ISP, it will discover that the request is for a ECS-buffered file and will call the ECS 
stack processor overlay 1EP into the same PP to handle the request. 

1EP requests a system double buffer to be set up in CM. The double buffer is used in ping-pong manner: 
half of the buffer is filled from the user's ECS buffer. While 1EP is writing this data out to the RMS file, 
the second half of the buffer is being filled. By the time the first half has been written out, the second half is 
full and 1EP can start writing it out while the first half is being filled. This ping-pong use of the system 
double buffer continues until the ECS buffer has been emptied and all data has been written out to the RMS 
file. The following illustrates the general flow of output to an ECS-buffered RMS file. 



CM 



System Double 
Buffer 




-©-- 



RMS 
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PERMANENT FILES 



A permanent file is a mass storage file cataloged so that its location and identification are always known to 
the system. A rotating mass storage device is designated by an installation to contain files made permanent 
by system users. Any file, regardless of content, which is not already permanent, may be made permanent 
by explicit request. Files on magnetic tape or ECS may not be made permanent. 

PERMANENT FILE FUNCTIONS 

The following permanent file functions are available as system macros: 

CATALOG an existing local mass-storage file, thereby making it a permanent 

file. 

ATTACH a previously cataloged file to a control point. 

RENAME a file in the permanent file directory. 

EXTEND a currently attached file by making permanent an extension to it. 

PURGE a file from the permanent file directory. 

SETP an established file position to which an attached file will be set 

when attached. 

ALTER allows the logical end-of-file to be set to the current file position. 

PERM allows a running program to determine what permissions have 

been granted to an attached file. 

FDB generates a file description block required for interface with the 

permanent file system. 

In addition, two SCOPE system macros and control cards may be used on an attached permanent file to 
logically detach it prior to job completion. 

macro: CLOSE lfn, UNLOAD or CLOSE lfn, RETURN 

control card: RETURN (lfn) or UNLOAD (lfn) 
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MACRO REQUESTS 

The permanent file functions CATALOG, ATTACH, RENAME, EXTEND, SETP, ALTER and PURGE 
are available either as control cards or running program macro calls. The same parameters are used for 
both; they differ in the call format and in the capability to test status in the running program. 

All permanent file macro requests share a common format: 

name fdbaddr,RC,RT,NR 

name Macro name written in a COMPASS instruction mnemonic field 

fdbaddr Address of fifth word in a file definition block (FDB) 

RC,RT,NR Optional parameters 

RC Returns a code to the FDB and gives control 

to the requestor on non-fatal errors. 

RT Returns a code to the FDB and inhibits per- 

manent file queuing. (Queueing occurs when 
a file cannot be attached immediately.) 

NR Specifies no recall. (All permanent file macro 

calls are issued in recall unless NR is 
specified.) 

Error messages will be written to the job dayfile, unless the RT or RC parameter is specified. 

PARAMETERS 

The parameters described below are common to both control cards and macro functions. With the excep- 
tion of lfn and pfn, parameters may be given in any order. Each is written in the form: cc = value or 
password where cc is a two-letter parameter code. The lfn and pfn parameters are position dependent; if 
one or the other is omitted, the lfn and pfn are considered to be the same string of characters. In the case 
when a pfn contains more than 7 characters in the parameter, the lfn will be the first 7 characters given in 
the pfn. 

!f n Logical file name; 1-7 character alphanumeric name (first charac- 

ter alphabetic) by which a file is known and referenced at a con- 
trol point. Once a permanent file is attached to a control point, it 
is referenced by this name. 

Pf n Permanent file name; 1-40 alphanumeric characters, assigned by 

file creator, under which a file is cataloged. 

RP Retention period in days, (0-999) specified by creator; indefinite 

retention indicated by 999. Installation default value is defined by 
the installation. 
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AC Account parameter; 1-9 alphanumeric characters. 

PP Privacy procedure parameter; 1-9 characters, used to pass infor- 

mation to installation-defined procedure. 

CY Cycle number (1-999) assigned by creator. Default value on initial 

CATALOG is 1, and on ATTACH, the highest number cataloged. 

LC Lowest cycle number cataloged is referenced when value given is 

non-zero; default is highest number cataloged. 

PW List of passwords used to establish user's access permission. Writ- 

ten as: 

PW = psw psw_,psw-, .psw n 



PW also is used in a CATALOG request when a new cycle is 
added or PUBLIC file created, and in a PURGE request in per- 
manent file name mode; up to five passwords allowed, each 1-9 
alphanumeric characters. 

TK Turnkey 

CN Control Password definition 

MD Modify 1-9 alphanumeric 

EX Extend characters 

RD Read 

XR Common 

MR If non-zero, gives read permission only which will permit read 

access of the file by other users. 

RW If non-zero, multi-read with single rewrite will be allowed. Instal- 

lation parameter can permit multi-read with multi-rewrite. If 
zero, and either CN, MD or EX permission is requested, exclusive 
access will be given. 

ID Identifies file creator; 1-9 alphanumeric characters. The ID name 

PUBLIC is reserved for PUBLIC files, and SYSTEM is reserved 
for SYSTEM files. 

ST Reserved for 6000/7000 compatibility 

FO File structure (ordering of data) is checked so that extend and 

modify permissions will have meaning for direct access (DA) or 
indexed sequential (IS) files. 

PS If non-zero, file is attached and positioned at a point established 

by SETP function. 
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EC Allocates ECS for permanent file I/O buffer. 

EC = K Allocate a standard number of IK blocks. 

EC = nnnn Allocate an octal number of IK blocks. 

EC = nnnnK Same as above. If K is omitted and P is not 

given, K is assumed. 

EC = nnnnP Allocate an octal number of ECS pages. 

UNIVERSAL PERMISSION 

An installation may define a combination of one or more permissions to be granted automatically by 
activating the universal permission option (IP.UP). A nine-character password is defined by the installation 
for such a permission combination. When this password is given on an ATTACH request, the permissions 
sltq granted. 

PUBLIC FILES 

If the public permission password is correctly specified, a file may be cataloged under the ID of PUBLIC 
then the user can omit the ID parameter on all permanent file requests. Attaching a PUBLIC file does not 
preclude the necessity of using correct permission codes. 

As all cycles of a file share the same ID, when the first cycle of a file is cataloged as PUBLIC, all subsequent 
cyces will become PUBLIC. With the RENAME function, a PUBLIC file can be given a new owner ID 
making it a private file. 5 1U ' 



MACRO REQUEST CALLS 

Each permanent file request macro expansion (except FDB) will generate an RA+ 1 call to the permanent 
hie PP program. All permanent file macro requests are issued with recall status set (bit 40 in word 2 of the 
request) unless NR (no recall) parameter is present in the macro call. 

An RA+ 1 call to a permanent file PP program has the following format: 

59 39 !7 n 



PP Program Name 



fdbaddr 



64 
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FILE DEFINITION BLOCK 



Parameters necessary for the execution of a permanent file function are contained in a central memory 
table called the file definition block (FDB). Error codes are returned to the user via the FDB. The FDB is 
generated automatically for control card calls, but it must be generated by an FDB macro for use by other 
permanent file macro calls. The format of the FDB follows: 



59 



(fdbaddr) 5 



17 



11 



Permanent File Name 
(Left Justified, Zero Filled) 



Logical File Name (Left Justified) 



Return 
Code 



Parameter Value (Right Justified, Zero Filled) 



RC 



FC 



Key 
Word 



0000 



Pfn 
If" 



Up to 40 display code characters, left justified with zero fill. 

Logical file name of 1-7 alphanumeric characters, left adjusted 
with zero fill. 
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The macro for generating an FDB has the following format: 

fdbaddr FDB lfn,pfn,parameters 

fdbaddr is the symbol associated with word 5 of the FDB; it must be 

present in the location field. 

parameters are separated by commas, and the list is terminated by a blank. 

Parameters include any of the 2 -letter parameter codes listed 
above. Parameters are entered into the FDB as they are encoun- 
tered in the list. 

The FDB is generated in-line during assembly whenever the macro is called. 

If the RC and RT parameter is specified in a macro call, a return code will be available to the user in word 
fdbaddr, bits 9-17. 

Word 5, bits 0-8, contain the PFM request code stored in the following format: 

Bit Content (when set) 

8 NR option given 

7 RT option given (implies RC given also) 

6 RC option given when bit is zero 

5-2 Function code (see list given below) 

1 Not used 

Function completed 
Binary Function Code: 

000 1 SETP 
0010 ATTACH 
0100 CATALOG 

0110 EXTEND 

0111 ALTER 
1000 PURGE 
1010 RENAME 
1 100 PERM 
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Request code examples (octal): 

020 Catalog; return error code and control to user on non-fatal error. 

130 Extend file; abort job on any error. 

210 Attach file; return error code on any error and inhibit file queuing. 

The parameter words of the FDB have the following format: 

59 5 




As shown above, parameters are stored, one per word in any order. Parameter code values are placed in bits 
0-5. The format of values entered in the parameter field is indicated in parentheses in the following list. 



00 
01 
02 
03 
04 
05 
06 
07 
10 
11 
12 
13 

14 

15 

16 

17 

20-24 

25 

26 

27 

30 

31 

32 

33 



PP 

RP 

CY 

TK 

CN 

MD 

EX 

RD 

MR 

SD 

XR 

ID 

RN 

AC 

EC 

PW 

FO 

PS 

PF 
LC 
ST 
RW 



end of FDB list 

privacy procedure parameter (display code) 

retention period in days (binary) 

cycle number (binary) 

turnkey password (display code) 

control pasword (display code) 

modify password (display code) 

extend password (display code) 

read password (display code) 

multi-read access only (binary) 

sub-directory (ignored in 3.4) 

control, modify, and extend password definition 

(display code) 

user identification (display code) 

automatic rename (ignored in 3.4) 

account name (display code) 

request ECS buffering of I/O (display code) 

submitted passwords (display code) 

file organization (display code) 

position setting (binary) 

used internally for checkpoint/restart 

permanent file (display code) 

lowest cycle (binary) 

6000/7000 compatibility 

multi-access rewrite (binary) 
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Word 5, bits 9-17, contain a 9-bit return code which can assume the following octal values; the associated 
message is written to the job dayfile. 

000 Function successful 

001 ID error 

002 lfn already in use 

003 Unknown lfn 

004 No room for extra cycle 

005 RBTC full 

006 No lfn or pfn 

010 Latest index not written for a random file 

1 1 File not on PF device 

1 2 File not in system 

013 (Not used) 

014 (Not used) 

1 5 Cycle number limit reached. Maximum value of cycle number is 999 

016 PFDisfull 

1 7 Funciion attempted on non-permanent file 

020 Function attempted on non-local file 

02 1 (Not used) 

022 File never assigned to a device 

023 Cycle incomplete or dumped 

024 File already attached 

025 File unavailable 
027 Illegal lfn 

033 ALTER needs exclusive access 

035 File already in system 
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070 PFM stopped by system 

07 1 Incorrect permission 

072 FDB address invalid 

On control card requests, all errors are fatal; on macro requests, unless the RC or RT parameter is specified, 
all errors are fatal. If RC or RT is specified, all error codes less than 070 will result in control being 
returned to the user. If 070 or greater, installation parameter IP.PFABT will determine whether or not the 
job is aborted. 

CATALOG FUNCTION 

CATALOG fdbaddr,RC,RT,NR 

For this request, the required parameters in the FDB are lfn, pfn and ID. If the permanent file name is 
unique to the ID specified, the request is considered an initial catalog. The initial catalog defines the 
passwords necessary to access any of up to 5 cycles that may be cataloged with the same pfn and ID. If 
there is no CY parameter specified, it is assumed to be 1. The following parameters are relevant on an 
initial catalog: 

CY Cycle number 

XR Control, modify, extend, common password definition 

CN Control password 

MD Modify password 

EX Extend password 

RD Read password 

TK Turnkey password 

RP Retention period 

FO File validity check 

RW Read with rewrite permission 

MR Multi-read access 

PW Password list 

AC Account parameter 

PP Privacy procedure parameter 

If a file with the same pfn and ID has already been cataloged, the request will be considered a new cycle 
catalog. If a CY parameter is not specified, it is assumed to be one larger than the highest cycle. Control 
permission must be established to do a new cycle catalog. The following parameters are relevant on a new 
cycle catalog: 

CY Cycle number 

PW Password list 

RP Retention period 

FO File validity check 

RW Read with rewrite permission 

MR Multi-read access 

PP Privacy procedure parameter 
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If RC is specified, the user is notified of a non-fatal error condition by an error return code at fdbaddr in 
the FDB. 

If RT is specified, the call is regarded as real-time. Specifying the RT option forces the RC option. In both 
cases, informative and diagnostic messages to the dayfile are suppressed. 

Initial Catalog Example: 

FDBA FDB LF1 ,MFILE,CN=Z ,MD=X,TK=Y, ID-ABC 



CATALOG FDBA.RC 

LF1 is assumed to exist on a valid permanent file device as a local file to this control point. 

The CATALOG macro references FDBA which contains the necessary parameters to make LF1 permanent. 

Since RC is specified on the CATALOG macro, control will be returned to the user on a non-fatal error; 
and a return code will be made available in location FDBA (bits 9-17). If RC is not specified, all errors 
result in termination and a diagnostic message. 

New Cycle Catalog Example: 

CATALOG FDB5 

EDB5 FDB LF16 ,MFILE , CY=12,PW=Y , Z , ID=ABC 

This job will add a second cycle to permanent file MFILE, created in the preceding example. File LF16 is 
assumed to be a valid local file on a permanent file device. The PW parameter is used to submit the 
passwords needed to obtain control permission. Had the initial catalog attempt aborted, MFILE would not 
exist; and this new cycle attempt would be processed as an initial cataloging. If successful as an initial 
catalog, the file would be unprotected as no passwords are defined in the FDB. An alternate form of the 
FDB could be used: 

FDB5 FDB LF16, MFILE, CY=12,PW=Y,Z,ID=ABC,TK=Y,CN=Z,MD=X 

The above FDB would perform equally as well for a new cycle catalog because the TK, CN and MD 
parameters would be ignored. If initial cataloging had failed, this FDB would catalog the file with protec- 
tion and the PW parameter list would be ignored. 
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ATTACH FUNCTION 

ATTACH fdbaddr,RC,RT,NR 

The ATTACH request requires the lfn, pfn and ID parameters in the FDB. The following parameters are 
optional: 

CY Cycle number to be attached 

PP Privacy procedure 

PW Password list 

MR Multi-read access 

LC Lowest cycle number 

PS Position value 

RW Multi-read/rewrite access 

EC ECS buffering for I/O 

RC parameter is the same as for CATALOG. When RT is specified, a code of 25 is returned to the FDB if 
the file is currently in use. If the RT parameter is not specified, the following circumstances will cause a job 
issuing an attach request to be queued for the desired file: 

File not available for exclusive access by requesting job 

Attached permanent file (APF)table full 

Archived file temporarily unavailable. The ATTACH request will cause a LOADPF job to be set up 
and scheduled through the tape scheduler. The job requesting the ATTACH will be swapped out 
until the file is available. Permanent file utility is running. 

If the CY parameter is zero or not present and the permanent file has multiple cycles, the default cycle 
attached is the one with the largest cycle number, presumably the latest cataloged. If the CY parameter is 
present and that particular cycle number is not known to the system, the request cannot be honored. If both 
LC and CY are specified, LC is ignored and the conflict is resolved. 

System evaluation of passwords establishes the type of access granted to the user for each file. Subsequent 
to ATTACH, the user cannot access the file in any way for which he does not have permission. For 
example, if ATTACH results in only READ permission, the user cannot subsequently attempt to use 
MODIFY or EXTEND. 

ATTACH does not preclude opening the file. The success of an OPEN request depends upon the permission 
granted when the file is attached. If the file is attached to another control point and multi-read access is not 
possible, PFM will wait for access to the file. 

Attach Example: 

FDBZ FDB LF,MFILE,MR=1,PW=Y,ID=ABC,CY=1 

ATTACH FDBZ,RC,RT 
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The permanent file MFILE is referenced again. Explicitly stating CY=1 ensures that cycle one will be 
attached. 

In the FDB, only the password for turnkey appears; EXTEND and READ permissions will be granted by 
default. In this example, the macro contains MR= 1; therefore all permissions except READ are ignored 
making the file available for multi-read access. 

In the macro request, the presence of RC and RT parameters would result in the octal code 25 being 
returned at location FDBZ if the file is unavailable. 



CATALOG 
CLOSE 



FDB1 

LF1, UNLOAD, RECALL 



ATTACH 



FDB1 



FDB1 



FDB 



LF1 , PERMF , TK=T , MD=M , EX=E , CN=C , PW=T , ID=ABC 



The above example illustrates several points. Assuming that local file LF1 has been created it is cataloged 
as cycle 1 (by default) of permanent file PERMF. The file is protected by turnkey, control, modify and 
extend passwords. The PW parameter in the FDB is ignored in cataloging. 

After cataloging is complete, a CLOSE/UNLOAD logically detaches the file from the job. 

As illustrated, the file PERMF now can be re-attached. Although not mandatory, the same FDB is used to 
conserve CM space. When PERMF is attached, the default cycle number is the largest cataloged- therefore 
cycle 1 is the only cycle present. The PW parameter contains the turnkey password giving READ access 
permission by default. This example illustrates an implicit read-only attach. 

The same example is shown with two FDBs: 



FDB1 
FDB2 



FDB 
FDB 



LF1 , PERMF , TK=T , MD=M , EX=E , CN=C , ID=ABC 
LF1 , PERMF , PW=T , ID=ABC 



CATALOG 
CLOSE 



FDB1 

LF1, UNLOAD, RECALL 



ATTACH 



FDB2 
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ALTER FUNCTION 

ALTER fdbaddr,RC,RT,NR 

The ALTER function causes the current position of an attached permanent file (designated by lfn in the 
FDB) to be recorded as end-of-information in the RBTC of that file. Permissions needed to perform the 
ALTER function depend upon the context in which function is issued. If the current position of the file is 
less than the file EOI (as attached), modify permission, extend permission and exclusive access are required. 
If the current position is greater than the file EOI, ALTER operates similarly to the EXTEND function and 
extend permission is required. The user can assure exclusive access with the RW parameter on the AT- 
TACH request. 

SETP FUNCTION 

SETP fdbaddr,RC,RT,NR 

The SETP function causes the current position of an attached permanent file (designated as lfn in the FDB) 
to be recorded in the PF tables. A subsequent attach request can specify a non-zero PS parameter, causing 
the file to be attached at the point established by SETP. If a SETP function has not been executed for the 
file, or the PS parameter value is given as zero, the file is attached at the beginning of information. SETP 
records a position only for the attached file cycle; if the file has other cycles, they will not be affected. 

The SETP function requires EXTEND permission. 

RENAME FUNCTION 

RENAME fdbaddr,RC,RT 

Any or all information cataloged by the user can be replaced through the RENAME function. The file must 
be attached to the requesting job with all permissions granted. A file owner can change permanent file 
name, cycle numbers, passwords, and even the user ID. 

In the FDB for this request, lfn is the only required parameter. The specified parameters will cause 
replacement of existing parameter information if they contradict the cataloged information. If they dupli- 
cate the cataloged information, the parameters are ignored. 

Parameters which could result in replacement: 

pfn Permanent file name 

ID Owner identification 

RP Retention period 

CY Cycle number 

TK Turnkey password 

RD Read password 

EX Extend password 

MD Modify password 

CN Control password 

AC Account name 

XR Common password definition 
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The PW parameter may be specified to submit the public password if the file ID is to be renamed PUBLIC 
Other parameters in the FDB will be ignored. Changing the ID, pfn, or passwords for any cycle cataloged 
will change all cycles. No ID, pfn, or CY changes are permitted if any of the cycles have been dumped 
(mode 2 dump) or archived as retrieval of such files would be impossible. RC and RT are as for 
CATALOG. 



Rename Example: 



ATTACH FDBA 

RENAME FDBB 



FDBA FDB 

FDBB FDB 



DFILE, MFILE, PW=Z,Y,X,ID=ABC 
DFILE, PFILE2,RD=W,MD=,CN=ZZ 



Assuming that MFILE was cataloged with X, Y and Z as passwords for modify, turnkey and control read 
access would be given by default when DFILE is attached as a local file. By RENAME action the cataloged 
permanent file name will be replaced with PFILE2. A new password, ZZ, will replace the existing password 
for control permission; a read password, W, will be cataloged for the non-existent read password The 
password for modify permission will be removed, and none will replace it. The owner's ID remains 
unchanged. Since no cycle number was given in FDBA, the cycle with the largest number will be attached- 
renaming will not change the existing cycle number, as no replacement is given in FDBB. 



FDBl FDB 

FDB2 FDB 

FDB3 FDB 



LFILE, MFILE, CY-9 ,RD=Y, ID-ABC 
LFILE, MFILE, CY=8,PW=X,Y,Z,ID=ABC 
LFILE, MFILE, RD=Z 



ATTACH FDB2 

RENAME FDBl 



RENAME FDB3 



This example illustrates that for renaming purposes, the same file can be called more than once in a job If 
the read password was originally cataloged as X, it is changed to Y when the file is renamed as cycle 9 and 
then finally changed to Z. The appearance of an identical ID parameter in FDB 1 will be ignored 



EXTEND FUNCTION 

EXTEND fdbaddr,RC,RT,NR 



Local extensions can be written at the end-of-information point of an attached permanent file and an 
extend function issued, thus extending the length of the permanent file. The file must be attached with 
EXTEND permission granted. 
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In the FDB, the required parameter is lfn; the extend password, if denned, must appear in the PW list. The 
extended section of the file will acquire the privacy controls of the permanent file. 

If lfn is an indexed file, the current index will be assumed to be the only valid index for the entire file. 
Random files must be closed before an EXTEND request is made. 

Extend Example: 

ATTACH FDBX 



EXTEND FDBX 



FDBX FDB LF1,PR0GLIB1,ID=XYZ 

The program that attaches permanent file PROGLIB1 as the local file LF1 writes beyond the end of 
information. Assuming that no password was required for extend permission, it would be given by default. 
Prior to program termination, the EXTEND request would make permanent any additions written to the 
file. 



PURGE FUNCTION 

PURGE fdbaddr,RC,RT,NR 

A cycle of a file can be removed from the catalog of permanent files by the PURGE function. In the macro, 
fdbaddr is required; RC and RT are as for CATALOG. In the FDB, the lfn is the only required parameter 
if the file was be attached before the purge function was issued. The optional parameters are: AC, CY, PP, 
LC, EC and PW. Control permission must be granted, or the job will be terminated. For the macro request, 
the FDB referenced may be one used at attach time; or it may be a new FDB. Only one cycle of a file may 
be purged at a time. When the last cycle of the file is purged, the entire permanent file name entry is 
removed from the directory and catalog. 

A user attempting to purge a permanent file already attached must specify the lfn under which the file was 
attached. This purge is by local file name, and the user need provide only the lfn in the FDB. 

To purge a file not already attached, the user must specify a local file name not in use at his control point. 
The permanent file name, ID and password list must be given. 
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PERM FUNCTION 

The PERM function is available only as a system macro. A running program can determine if a file is a 
non-permanent local file or what permissions have been granted to a currently attached permanent file. 

PERM fdbaddr,RC 

The lfn of an attached permanent file should be given in the FDB. This macro produces a 5-bit code in the 
fdbaddr return code field. The bits represent the following information: 

Bits 0-3 

1000 CONTROL permission 

0100 MODIFY permission 

00 1 EXTEND permission 

0001 READ permission 

Bit 4 

1 non-permanent file 

permanent file 

A return code of zero signifies that the lfn was not in the FNT for the control point (a non-existent file) or 
that some other error was detected. 

Perm Example: 

FDBA FDB DFLN.PFILE, CY=1 ,PW=XXX, ID=ABDC 



ATTACH FDBA.RC 



PERM FDBA 

Assuming the file had been cataloged with passwords required for control and modify permissions, the 
ATTACH request would have generated control permission by the password XXX and read and extend 
permissions by default. A subsequent PERM request would cause an octal 13 value to be returned to the 
FDB. The code indicates a permanent file is attached with read, extend and control permissions. 
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PERMANENT FILE UTILITY ROUTINES 

The utility routines provide the capability for dumping permanent files to tape, loading dumped files from 
tape, transferring permanent files and tables from one mass storage device to another, and producing 
printed reports on the status of each permanent file. 

Four routines perform these functions: 

DUMPF Copies all mass storage resident permanent files to tape. The purpose is either to clear 
all permanent files from mass storage devices or to provide periodic back-up files for an 
installation. 

LOADPF Counterpart of DUMPF; required to reload permanent files from tape to mass storage. 

TRANSPF Enables permanent files and/or related tables to be transferred to a public RMS 
device. The device from which they are transferred is no longer a PF/PFD device. 

AUDIT Produces a formatted output file containing statistics on all permanent files in the system. 

A permanent file utility job deck should contain job card and program call cards for utility routines. The 
job card specifies name, priority, time limit, field length and tape requirements. AUDIT requires a field 
length of 35000. DUMPF requires 20000; LOADPF requires 31000; TRANSPF requires 10000. 

A permanent file named DUM, having an ID of PUBLIC, and a public permission password, must be 
cataloged in the system before a DUMPF or TRANSPF function may be called. Control cards calling these 
functions must include required passwords for the appropriate file, for which an implicit attach will be 
performed. The LOADPF and AUDIT routines reside on the SCOPE system library; they are called with a 
standard program call card. 

In default mode, the DUMPF and LOADPF routines request the operator to assign a labeled SCOPE 
internal tape written at 800 bpi density. The tape will be rewound prior to writing or reading, and it will be 
unloaded at job termination. 

GENERAL RESTRICTIONS 

1 . The permanent file system must be inactive when DUMPF and TRANSPF are running. If the system is 
active when the first copy of the dump or transfer routine is loaded, the permanent file utility job will 
go into recall until all permanent file manager activity has ceased. 

2. The utilities must be called by program call card. 

3. Dumping of a specific unit when IP.ARCH=0 and MO = 2 (all RBs associated with the files are re- 
leased) will cause all permanent files dumped to be unavailable until reloaded from the dump tape by 
the LOADPF routine. Consequently, these files may not be attached and, therefore, cannot be purged. 

4. If the device containing the PFD/RBTC is dumped, all permanent files in the system must be dumped. 
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5. An archived dump (MO = 2 and IP.ARCH= 1) sets flags in the PFD and RBTC to signal that a file is 
saved on a dump tape. Record blocks assigned to the file are released. Archived files can be retrieved by 
the ATTACH function, depending upon the IPARCH setting. An archived file can be purged by not 
reloading it. 



DUMPF 

To execute the DUMPF utility, the control card must inlcude passwords required to obtain read permission 
for the cataloged file DUM. An explicit attach should not be performed, as an internal attach occurs when 
the DUMPF utility is called. 

To allow simultaneous execution of DUMPF routines at several control points, DUM is internally attached 
with MR= 1 to achieve multiple access of the file. The control card may include a mode parameter and a 
type parameter; in addition, the passwords for file DUM must be specified. The control card parameters are 
order independent and are written: 



DUMPF(MO = n,keyword = type.PW = passwords) 



Mode Parameters 
MO=l 

MO = 2 



Description 

Record blocks will not be released after being dumped; the file will be 
available. (Default) 

Record blocks will be released as they are dumped. Depending on the 
archive installation parameter, the file may still be available; if not, it 
must be explicitly reloaded to become available. 



Type Parameters 
UN = EST ordinal 

DA = Julian date 

ID = name 
DP = A 
DP = C 

DP = X 

IN = n days 



Description 

All files residing completely or partially on the device indicated by the 
unit EST ordinal will be dumped. 

All files rewritten, extended, renamed, altered, or cataloged after a 
specified date will be dumped. Date is in the form yyddd. 

All files having the ID name specified will be dumped. 

All files in the system will be dumped. (Default) 

All files created or changed after the last dump was taken will be 
dumped. 

All expired files will be dumped. 

All files that have not been attached in n days are considered inactive 
and will be dumped. 
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JN= Julian date 



TI = time 



All files that have not been attached since (and including) the date 
given will be dumped. Date is in the form yyddd. 

A time value to the nearest minute may be used in conjunction with 
the JN and DA parameters. Time is in the form hhmm. 

Several copies of the dump routine can execute concurrently at different control points if all copies have the 
same mode and type parameters. 

The TR = 7 or TR = 9 parameter can be used with any mode or type parameter to indicate whether the 
dump tape is 7-track (800 bpi) or 9-track (1600 bpi); TR = 7 is the default parameter. 

If MO = 2 and the unit specified by the UN type parameter contains the PFD. the operator has the choice 
of typing GO for a full dump or typing DROP. DUM is dumped under MO= 1 but not under MO = 2. 

DUMPF writes the dump to a multireel magnetic tape file having the format shown in the following figure: 



Tape Label 

" 



File 
Label 



Dumped 

Permanent 

File 



Next 

File 

Label 



Volume and Header Labels 



EOR (end of tape label) 



8-word header 

PFD entry (16 words) 

RBTC information 



Contents of dumped file 



Last EOR of dumped file 



EOF Tape Mark 



8-word Header 
PFD 
RBTC 



Figure 6-1 . Permanent File Dump Tape Format 
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59 



53 



8-Word Header (Format is same as file header label on tape) 
47 41 35 29 23 17 11 



V 



X 



N 




A 



A 



A 



A 



A 
A 



PFD Entry of Dumped Format 



RBTC Entry up to and Including the First Word of the RBT Chain 
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Information in the first 20 characters of tape label: 

HDR1DUMPF TAPE- NEW 
Or: 

VOL1DUMPF TAPE- UNIT 



FIELD 


LENGTH 


FIRST 




(No. 


of 




CHARACTER 


FIELD 


characters) 


POSITION 


DESCRIPTION 


3 






1 


HDR 


1 






4 


1 


17 






5 


DUMP TAPE OF P.F 


6 






22 


(blank) 


4 






28 


0001 


4 






32 


0001 


4 






36 


(blank) 


2 






40 


01 


1 






42 


(blank) 


5 






43 


BIRTH 


1 






48 


(blank) 


5 






49 


NEVER 


1 






54 


X 


6 






55 


000000 


20 






61 


(blank) 



NAME OF FIELD 

Label identifier 

Label numer 

File label name 

Multifile identification 

Reel number 

Multifile position number 

Reserved for tape compatibility 

Edition number 

Reserved for tape compatibility 

Creation data 

Reserved for tape compatibility 

Expiration Date 

Security 

Block count 

Reserved for tape compatibility 
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LOADPF 



With this utility, the user can reload permanent files that have been previously dumped to tape. He can 
select specific files to be reloaded from a dump tape. Ordinarily, reloaded files will be restored to the device 
from which they were dumped. If it is not possible, the files will be loaded on another device having the 
same allocation type. If no such type device exists, the files will be reloaded to any other PF device in the 
system, if one exists. 

The job deck for loading dumped files does not require a REQUEST card for the dump tape; the tape is 
requested by the main reload routine, LPF. The reload utility is called by the program execution (call) card 
in the form: 



LOADPF(keyword = parameter) 

Mode Parameters 
MO=l 
ID = name 
PF = name 

CY = name 



Description 

Full load of files of dump tape, (default) 

All files having the specified ID name will be loaded. 

Used only in conjunction with the ID = name parameter. To be 
loaded, the files must have both the specified ID and permanent file 
name. 

Used only in conjunction with the ID and PF parameters. To be 
loaded, the file must have specified ID, permanent file name and 
cycle numbers. 



Type Parameters 
LP = X 
LP = R 
LP = 

UN = EST ordinal 



TR = 7 
TR = 9 



Description 

Expired files will not be loaded; normally, all files will be loaded. 

Replace existing versions of files. Normally, files are not replaced. 

Dump tape is not in 3.4 format. 

Files will be loaded into a specified unit; normally, they are not 
loaded on a particular unit. 

Dump tape to be loaded is specified as 7 (800 bpi) or 
9-track (1600 bpi). Default is 7-track. 



The control card may contain a mode parameter and five type parameters. If a parity error occurs during 
loading, the file will be nagged in the permanent file table. Several copies of LOADPF can run 
concurrently. 
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ARCHIVE FEATURE 

The archive feature is automatic, and the user will be unaware of this system activity when loading is from 
tape. When an attempt is made to attach an archived permanent file, the operator may type n.GO which 
causes the file to be loaded from the appropriate dump tape. An archived file can be purged without 
actually loading the file. 



TRANSPF 

When calling the file transfer utility, the control card must contain the EST ordinals of the devices involved 
and the password list for the permanent file DUM. 

Control card format: 

TRANSPF(El=estl,E2 = est2,PW = passwordlist) 



estl 



Indicates the device containing the permanent files and/or tables 
to be transferred. If it is a PFD device, the PF tables will be 
transferred. 



est2 Device to receive files and/or tables. Must be a PF device if the 

permanent files are to be transferred. 

If the transferred data overflows the device, the overflow will be written to another PF device. If no device 
is available, the file being copied will not be transferred. Permanent file tables will be transferred only if 
they exist on the device referred to by the estl parameter. TRANSPF will do a destructive copy of the old 
permanent file tables. If the tables cannot be written to a contiguous area within the first RBR on the est2 
device, the job will be dropped. 

Several copies of TRANSPF can execute simultaneously at different control points while transferring 
permanent files, as TRANSPF specifies MR= 1 in its internal attach of the file DUM. 



AUDIT 

The AUDIT utility provides printed reports containing basic accounting information. AUDIT runs in two 
modes. Full mode produces a printed report containing all the information listed below. A partial audit 
produces only the items marked with *. 



*Permanent file name 

* Owner ID 

* Cycle number 
*Creation date 

I *Expiration date 
*Date of last attach 
*Date of last alteration 
*Account name 
*Size in number of PRUs 

* Public device EST ordinal 



Number of attaches 
Number of extends 
Number of rewrites/alters 
File size (number of RBs) 
Subdirectory 

Archive flag (VSN printed) 
Time of last attach 
Time of last alteration 
VSN(s) of files dumped 
Loading parity error flag 



Positioning flag 
Random flag 
SAAM flag 
New version flas 
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The type of audit produced is determined by the type parameter given on the AUDIT control card, the 
format of which is: 

AUDIT(keyword = parameter, ) 

AUDIT output is normally directed to the job OUTPUT file, unless another file is specified in the destina- 
tion parameter on the control card. Only one mode parameter may be elected; if none is given, an audit of 
all files is assumed. 



Destination 
Parameters 

LF= OUTPUT 

LF = lfn 

Type 
Parameters 

AI = F 

AI = P 

Mode 
Parameters 



Description 

Audit information is written to job OUTPUT file. (Default) 
Audit information is written to file designated by name lfn. 

Description 

Full audit files. (Default) 
Partial audit. 

Description 

Audit all files. (Default) 

Audit archived files. 

Audit all expired files. 

Audit inactive file cycles. 

Audit incomplete file cycles. 

Audit files with parity errors. 

Audit all files having ID name. 

Audit all files on unit having EST ordinal. 



MO = A 

MO = R 

MO = X 

MO = D 

MO = I 

MO = P 

ID = name 

UN = est ordinal 

Examples: 

DUMPF(M0=1,ID=ABC,PW=X,Y,Z) 

All permanent files with the ID of ABC will be dumped and the record blocks will not be released. The 
passwords X, Y, Z indicate file DUM is to be attached with permissions corresponding to the three pass- 
words defined when the file was cataloged. The read password should be included. 

L0ADPF(UN=O2) 



6-24 



60306500 A 



Permanent files on the dump tape will be restored to the device with the EST ordinal 02. 

TRANSPF(E1=03,E2=15,PW=B) 

File DUM will be attached with the permission corresponding to password B which should establish read 
permission, at least. Permanent files and tables on the mass storage device with EST ordinal 03 will be 
transferred to the mass storage device having EST ordinal 1 5 if E 1 is a PFD device and E2 is a PF device. 

AUD I T ( M0=X , AI =P , LF=Y0UR } 
All expired permanent files will be written to the output file YOUR; a partial audit will be produced. 
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All 
Files 


Archived 
Files 


Expired 
Files 


Files of 
Same ID 


Files on a 
Certain Unit 


Partial 
Audit 


Full 
Audit 


Owner ID 


X 


X 


X 


X 


X 


X 


X 


Permanent File Name 


X 


X 


X 


X 


X 


X 


X 


Cycle Number 


X 


X 


X 


X 


X 


X 


X 


EST ORDINAL 

(If on a Public Device) 


X 




X 


X 




X 


X 


Creation Date 
(Julian) 


X 


X 


X 


X 


X 


X 


X 


Expiration Date 
(Julian) 


X 


X 


X 


X 


X 


X 


X 


Date of Last Attach 
(Julian) 


X 


X 


X 


X 


X 


X 


X 


Date of Last Alteration 
(Julian) 


X 


X 


X 


X 


X 


X 


X 


Account Parameter 


X 


X 


X 


X 


X 


X 


X 


Number of Attaches 


X 


X 


X 


X 


X 




X 


Number of Extends 


X 


X 


X 


X 


X 




X 


Number of Rewrites 


X 


X 


X 


X 


X 




X 


File Organization 


X 


X 


X 


X 


X 




X 


Flag Archived File 
By Printing VSN 


X 


X 


X 


X 


X 




X 


Length (No. PRUs 
determined by Inst. Par.) 


X 




X 


X 


X 


X 


X 


Flags 


X 


X 


X 


X 


X 




X 


Subdirectory 


X 


X 


X 


X 


X 




X 


Length in RBs 


X 




X 


X 


X 




X 


Time of Last Attach 


X 


X 


X 


X 


X 




X 


Time of Last 
1 Alteration 


X 


X 


X 


X 


X 




X 



Figure 6-2. Table of AUDIT Outputs 
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Permanent File Utility Function Codes (octal): 



AUDIT 


166 


DUMPF 


172 


LOADPF 


174 


TRANSPF 


176 



Permanent File Utility Keyword Codes (octal): 
Keyword Code 



TR 
MO 

UN 
DA 
DP 

IN 
El 

E2 

LP 

JN 

TI 

AI 

LF 

ID 

PF 

PW 
CY 



57 
60 
61 
62 
63 
64 
66 

67 

70-73 

74 

75 

76 

77 

14 

30 

20-24 
03 



Description 

(...) indicates format of values in FDB 

Dump tape type 7 or 9 track (binary) 

Load or audit dump mode (display code) 

Dump, load or audit unit EST ordinal (binary) 

Date parameter for file dumps (display code) 

Dump mode parameter (display code) 

Inactive file dump parameter (binary) 

Transfer files tables from unit EST ordinal 

(binary) 

Transfer files tables to unit EST ordinal (binary) 

Load type parameter (display code) 

Date parameter for file dumps (display code) 

Time parameter for file dumps (display code) 

Audit type parameter (display code) 

Audit output file parameter (display code) 

Load by file ID name parameter (display code) 

Load by ID and pfn names parameters (display 

code) 

Passwords to attach file DUM (display code) 

Load by ID, pfn and cycle parameters 
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PERMANENT FILES/SYSTEM INTERFACE 

Three pointer words in the CMR pointer area contain pertinent file system information as follows: 
P.PFM1 (word 6 in CMR) 



C.SDTL 



C.APFL C.PFACT 



C.APF 



C.PFMCH 



N.SD 

■ — 


N.EAPF 


Activity 
Count 


T.APF 


Toggle Byte 



C.SDTL 
C.APFL 
C.PFACT 

C.APF 
C.PFMCH 



N.SD is the number of subdirectories in the system 

N.EAPF is the number of entries in the APF table 

Number of files being attached or cataloged not having APF 
entries 

T.APF is the FWA of the APF table (18 bits) 

PF toggle byte used for interlocking disk and CM tables. Inter- 
locks in effect are indicated by bit settings: 



Reserved 


9 


f 


e 


d 


c 


b 


a 



a 


S.RBTCW 


RBTC Wraparound 


b 


S.APFIL 


APF Interlock 


c 


S.PFDIL 


PFD Interlock 


d 


S.RBTCIL 


RBTC Interlock 


e 


S.PFUTIL 


Utility 


f 




Not used 


S 


S.TRANIL 


TRANSPF Interlock 



P.PFM2 (word 7 in CMR) 



C.SDL 


C.MDL 




C.MD1 


C.MD2 


CMD3 




N.ESD 


N.MD 


1 1 






1 1 







C.SDL 
C.MDL 
C.MD1,2,3 



N.ESD is the number of available slots in each subdirectory (4 per PRU) 
N.MD is the number of master directories. 
Pointers to the master directories 
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P.PFM3 (word 17 in CMR) 

C.RBTC1 C.RBTC2 



C.RBTC3 



C.RBTCL 



C.PFFNT 



i r 

Current RBTC Pointer 



1 



1 



N.RBTC 



FWA of PF 
FNTs 



C.RBTCL N.RBTC is the number of PRUs in the RBTC divided by 16 

decimal 

C. RBTC 1,2,3 Pointers to current end of information in the RBTC 

C.PFFNT Pointer to first word of permanent file directory FNT area 
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SYSTEM PERMANENT PACKS 

An installation may choose to have its permanent file system on 854 or 841 disk pack devices; this would 
facilitate the transfer of the permanent file system from one hardware configuration to another without the 
use of the permanent file utilities. One of the packs must be declared a PFD device and the other packs 
declared PF devices. Deadstart has an option to provide for the addition of these packs. In either configu- 
ration, all packs must be mounted while the software system is running. The system files created at dead- 
start may be on an RMS device that is not a PF device; such a device, however, must be a system device. 

PERMANENT FILE TABLES 

There are four system files created as permanent files during system deadstart: the system dayfile, the CE 
error file, the edit-extension file, and the system (library) file. Each has an entry in the permanent file 
directory (PFD) and the RBT catalog (RBTC). 

PFD and RBTC are of fixed length, and reside on the same mass storage device. At deadstart, an FNT 
entry is made for the RBTC as ORBTC, and multiple entries are made for PFD as 0SD001, 0SD002, 
corresponding to each of the subdirectories. The RBTC and all PFD/FNT entries are attached to'control 
point zero and entered at the high end of the FNT. This arrangement prevents an unauthorized user from 
interfering with the operation of the Permanent File Manager (PFM). 

The APF Table is CM resident and consists of two word entries, up to a predefined size for the installation 
(LAPF, default of 30 decimal). 

The PFD, detailed in figure 6-3, consists of a header at the beginning of subdirectory 1, followed by a 
number of subdirectories of equal length. The PFD header is a copy of the PFD's RBT chain for use in recovery. 
Each subdirectory consists of PFD entries as shown in figure 6-4. 

Up to five cycles or versions of each permanent file can be maintained. The PFD entry, therefore, can have 
up to five pointers to the RBTC, each corresponding to an entry for a cycle. Each pointer has a byte (word 
7 of PFD entry), which contains two 1-bit flags and the cycle number. The first flag, if on, signifies that this 
cycle has been dumped and is unavailable; the second signifies the entry is incomplete as no RBTC entry 
exists. 

When cataloging, the user may specify the number for the cycle or permit a cycle number to be generated 
automatically. Unless the user specifies the cycle when attaching a file, he will get the one with the highest 
cycle number. Cycle numbers range from 1 to 999. 

The permanent file name (pfn) can consist of up to 40 characters. The PFD entry also contains the 
passwords given when the file was cataloged. PFD entries are placed into appropriate subdirectories by a 
hashing algorithm applied to the file's ID. 

The flag in word one of the PFD entry signifies that all cycles have been dumped, (used by utilities only.) 
The entry-in-use flag is set when an entry is built. Detailed formats of the RBTC and RBTC entry appear 
in figures 6-5 and 6-6. 
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Sub-directory 1 



Sub-directory 2 



Sub-directory n 



Copy of RBT chains for 
PFD sub-directories 



PFD entry 1' 
PFD entry 2 



PFD entry m 

PFD entry 1" 
PFD entry 2 



.PFD entry m_ 

"PFD entry 1 ' 
PFD entry 2 



k L.PFD entry m 



For use by deadstart 
recovery 



Figure 6-3. Permanent File Directory 
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59 



47 



35 



23 



11 



10 



11 



12 



13 



14 



15 



16 



7777 



8 



PF 



D3 



Subdirectory 
(ID Hash) 



(Right Justified, 
Blank Filled) 



OWNER-ID 



PERMANENT FILE NAME 
(Left Justified, Zero Filled) 



Cycle 



RBTA 



RBTO 



PRU 



RBTC 
PRU* 



TK Password 



CN Password 



MD Password 



EX Password 



R D Password 



C.PDFLAG 

PFN 
Hash 



(Right Justified, 
Zero Filled) 



S.PFDEU 
(Entry in Use) 

Utilities Flag 



14B 



FDB 
Code 



Dump Flag 
Incomplete Flag 



Archived 
Parity Error 



Byte number of RBTC PRU first word. (Word contains an index to the start of the RBTC entry in that 
PRU.) 



Figure 6-4. PFD Entry 
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ENTRIES FOR PERMANENT FILE TABLES 
(LAST THREE ENTRIES IN FNT) 



59 


47 




17 





00 R 


B 


T 


C 00 00 




C.FEQP 
Device Type 


Pointer to First PRU after Chain 




00 S 


D 





1 00 




C.FEQP 
Device Type 


Pointer to First PRU after Chain 


C.FSDT 
SD Entry Count 




00 S 


D 





2 00 






Pointer to First PRU after Chain 


C.FSDT 
SD Entry Count 





L 



Label for RBTC 
Copy of RBT 

Chain assigned to RBTC for recovery purposes 

RBTC entry 
RBTC entry 
RBTC entry 

RBTC entry 



I 

J 



Figure 6-5. RBT Catalog 
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59 


47 


35 


23 


11 


5 


1 


7777 


7777 


RB 


TC 


C.PCFLAG 
Flags 


2 


(Right Justified, 
Blank Filled) 


OWNER-ID 




14B 


3 






PERMANENT 
FILE 
NAME 




4 








5 








6 








7 


PFD Pointer 


CYCLE 


8 


Creation Date (J-Date) 


Retention 
Period 


EST 
Ordinal 


9 


Date of Last Attach 


Time of Last Attach 


10 


Date of Last Alteration 


Time of Last Alter 


11 


Number of 
Attaches 


Number of 
Extends 


Number of 
Rewrites 


Size of 
Entry 




12 





Pointer 
toS 


Pointer 
toT 


Subdirectory 


(Reserved) 


13 


Account Parameter 




14 


Dump Tape VSN No. 1 


Position 


15 


Dump Tape VSN No. 2 


POSiti ° n (CKP) 

















Installation Slot 



RBT Chain 



Index- 



C.PCFLAG 
11 10 98 76543210 



9-Track 
Positioned 

Random 
FO=IS/DA 



±1 



Index 



Word of an RBTC pru. 



index- 



Figure 6-6. RBTC Entry 



t 



S.PFCEF(Entry Free Flag) 

New Version 

Archive 



Index,, 



Number of Free 
Words in this PRU 
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The RBTC consists of a header and a number of variable length RBTC entries which are not necessarily 
contiguous. If an RBTC entry will not fit entirely into one PRU, it is forced to start at the beginning of the 
next PRU. The header is a copy of the RBT chain for the entire catalog used by deadstart in recovery. Each 
RBTC entry has a copy of the pfn as well as other relevant information as shown in figure 6-6. Figure 6-2 
indicates the information recorded in the RBTC entry that is printed for a file audit, depending on the 
mode and type of the audit. 

Figure 6-7 is the format of the APF entry. Whenever a permanent file is attached to a control point, an 
entry is made for it in the APF table. A pointer in the first word of an FNT entry for a permanent file 
relates that entry to the corresponding APF entry. The APF table is an interlock list which allows multi- 
read access without reloading the RBT chains and also controls queuing for exclusive use of the file. 



59 




47 




35 




23 


17 







C.PFD1 




C.PFD2 I 


C.PFD3 


C.PFD4 


C.PFQ 
PFQ Address 










C.PFRBT 
First RBTA 


C.PFCNT2 
Count 2 


C.PFCNT 
Count 1 


C.PFCY 
Cycle No. 


C.PFLAG 
Flag Byte 





Word 1 



Word 2 



C.PFLAG 



11 10 98 76543210 



(Reserved) 
(Reserved) 
System PF 
Obsolete FRBT 
Archive 
Utilities 



!i 



£ 



Priority lockout 
Single write 
Single modify 
Exclusive access 
(Reserved) 
Interlock 



Figure 6-7. APF Table Entry 



INCOMPLETE CYCLE 



An incomplete cycle is a file that has a PFD entry but no RBTC entry. It can result from either a CATA- 
LOG or LOADPF job that does not terminate normally. An incomplete cycle may be attached and purged 
if the CY parameter is used to specify the cycle and control permission is established. 
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JOB PROCESSING 



JOB FLOW 

SCOPE processes jobs in the system in three sequential, independent stages: Input, Scheduling, Output. 
Many jobs may be in any one of the three stages. 

Jobs can be loaded into the computer by reading card decks into the system using the system package 
JANUS. Alternately, they may be input from tape with the tape loader (1LT) or from a user terminal 
through INTERCOM. When the job has terminated, JANUS is assigned to process the OUTPUT, PUNCH, 
and PUNCHB files produced by the job. 

A job comes under scheduler control after all system resources specified on the job card have been assigned 
to it. When a job is under scheduler control, it has an assigned job description table entry and is in one of 
the scheduler queues; or it has been assigned to a control point. When it is assigned to a control point, the 
control point status values will indicate either the type of activity or that activity at the control point has 
been suspended. With the job swapping/rolling features of SCOPE 3.4, several jobs may be considered to 
be assigned to each control point. 

A job is in execution only when it is assigned a control point and central memory and is actively using a 
central processor. Then SCOPE executes the job as directed by the control card record of the job's input file. 

JOB INPUT QUEUE 

As each job is read into the computer by JANUS, the tape loader 1 LT, or INTERCOM, it is placed into the 
job input file and a FNT entry for the job is created in the job input queue. 

JANUS, 1LT and INTERCOM call the PP overlay 2TJ to translate the JOB control card. 2TJ scans the 
card, checks the parameters for validity, computes a priority value for the job, determines the job class, and 
passes all this information back to the PP program which called it. 

The PP program 1 IB scans the job input queue, looking for jobs eligible for execution scheduling. To be 
eligible, all resources requested on the job card, must be available, except for central memory. A job will 
remain in the input queue if it is dependent on a job which has not run, it is waiting for operator tape 
staging, or the job is not to be brought to a control point, or the amount of ECS it requested is not 
available. 
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TAPE JOB SCHEDULING 

All incoming jobs requiring a specific number of 7 and/or 9-track tapes (as defined by MT or NT parame- 
ters on the job card) are entered in the pre-input queue, a subset of the input queue. The operator commu- 
nicates with the pre-input queue through DSD type-ins and the P display. Each time the operator requests a 
P display, the jobs displayed are the highest priority tape jobs in the queue. A job requiring tapes is not 
placed in the normal job input queue until the operator releases it with a type-in. Once released, the job will 
be considered for assignment to a control point and execution; it no longer appears in the prescheduling 
display. Tape drive scheduling is described in Section 4 under non-allocatable devices. 

LOADING JOBS FROM TAPE 

The PP routine 1LT is used to load jobs onto disk via magnetic tape. 1LT is called to a control point by 
DSD when the operator initiates a keyboard entry in the format: 

n.LOAD,g,p. 

n is the number of the control point to be used. 

g is an optional parameter specifying the number of the file group to be loaded. 

p is an optional parameter specifying the number of the job in file g to be loaded. 

Both g and p are one or two octal digits. 

A standard circular buffer technique is used to process input files. The first card of the first record in each 
file is presumed to be a JOB card, and it is processed accordingly. This assumption is made for each job on 
the tape. CIO and its overlays are called to read the tape into memory and write memory to disk. 

1LT is released when all jobs from a tape have been processed. A double end-of-file on tape signals the end 
of a group of jobs; when it is encountered or when an error condition is detected at the control point, 
control is transferred to the PP idle loop. 

The number of control cards which may appear in a given job is not limited. If the user fails to place an 
end-of-record (7/8/9) card behind the control card record of a job, the omission will not be detected by 
either 1LT, JANUS or INTERCOM until the job runs. 
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JANUS 

The unit record I/O package - JANUS - consists of the following PP programs: 



1IQ 

IIS 

1IR 
1IU 
1PL 
1FM 



Input/output queue manager; sets up a control point to read jobs 
from card readers and to print or punch job output files; handles 
DSD type-ins and displays 

Called by 1 IQ to load a group of overlays into the field length for 
use by 1 IR 

Card reader, card punch, and printer driver 

Called by 1 IR to backspace print files when necessary 

Dummy output file driver for plotter 

Dummy output file driver for film/hard copy devices 



Display 
Driver 



JANUS 

Input Queue 

Output Queue 

Manager 




Card Reader/Punch 
and Printer Driver 



Backspace 
Print File 



Initialize 

JANUS 

Control Point 



1FM ) Film Drive (dummy) 



Plotter/Hard Copy 

Driver 

(dummy) 



JOB Card 
Translation 



JANUS Interfaces 
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INTEGRATED SCHEDULER 

The job scheduling scheme implemented in SCOPE 3.4 is made up of the following: 

allocator IRA is replaced by the following: 

Scheduler 

(MMGR) CPU program operating at control point zero in 2-to 3-millisecond cyclical intervals, it 

allocates control points and central memory to jobs and determines which jobs should 

be swapped/rolled in and/or out. 

HB Brings jobs from input queue to CM queue; builds JDT entries for jobs. 

1RN PP program operating at control point zero at about one-second intervals. One of its 

functions is to age jobs in the input and output queues. 

Swappers PP programs called to swap or roll jobs in (1SI) or out (ISO) and to initiate new 

INTERCOM jobs. 

1DM PP program which processes job entries in the device queue. 

1PF PP program which processes job entries in the permanent file queue. 

1CI PP program which processes job entries in the INTERCOM queue. 
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( JANUS J 




1LT 



Input/Pre-input 
Queue 




■/intercom) 



CM 
Queue 



Scheduler 
1RO/1SO 
1RI/1SI 
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SCHEDULER REQUEST STACK IN SYSTEM EXCHANGE PACKAGE AREA 



T.XPIDLA |~ 



W.CPUST/W.CPSLIC 

W.CPTIME 

W.CPTIMB 

W.PPTIME 

W.XPIR 

W.XPOR 

Scheduler Only 
T.SCHRS 

T.MTRRS 



Exchange Package 



Integrated Scheduler 
Request Stack Table 



L.SCHRS=4 



CPMTR MTR Request Stack 



L.MTRRS=4 



i 



V 



17 
20 

21 

22 

23 

24 

25 
26 



31 
32 



35 
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59 



W.PTFLAG 



W.PTCLK 



W.PTIDL 



W.PTSCP 



W.PTPPI 



W.PTNST 



W.PTVST 



W.PTNSW 



W.PTVSW 



W.PTTSW 



W.PTNJP 



SCHEDULER PERFORMANCE TABLE (IP.SPT OPTION SET) 



29 



Flags 



Elapsed Time 



CPU Idle Time 



System Program Execution Time 



PPU Idle Time 



Number of Storage Moves 



Number of Words Moved 



Number of Swap-outs/Roll-outs 



Number of Words Swapped-out/Rolled-out 



Swapping Time 



Number of Jobs Processed 



Reserved for Storage of Intermediate Times 



S.PTNSTD — Manual/benchmark option selected 

S.PTINIT - Initialization of TSPT 

S.PTSTOP — Stop data gathering 

S.PUBNCH — Benchmark option selected 

S.PTFJOB — First Job execution started 



S.PTNSTD 

S.PTINIT 1 

S.PTSTOP 1 

S.PUBNCH 1 I 

S.PTFJOB -i 1 \V 
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JOB SCHEDULING 

In SCOPE 3.4, user jobs in execution can be either swapped or rolled in or out of central memory by the 
integrated scheduler or by the operator. This feature of the job scheduling scheme allows dynamic alloca- 
tion of control points and central memory. If the scheduler needs a control point or central memory, it need 
not wait for a job to terminate. Such a scheme permits more efficient servicing of a mixed group of jobs, 
such as INTERCOM, remote batch, local batch and time-critical. System jobs such as JANUS and 
LOADER can not be swapped or rolled. 

ROLLING 

A job will be rolled out instead of swapped out under the following conditions: 

Job has direct-access ECS assigned 

Job has non-allocatable equipment assigned 

Job is in device queue 

Job is in operator action queue 

When a job is rolled out, its field length is written to an allocatable file and all of its memory, except RA + 
through RA + 77, is released. The control point remains assigned to the job and its JDT entry is placed in 
the appropriate queue. When a job is rolled in, it begins active use of its control point. 
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SWAPPING 

A job may be swapped out under the following conditions: 

Job is waiting for CM queue 

Job is in permanent file queue 

Job is waiting for INTERCOM terminal I/O (job is in INTERCOM queue) 

When a job is swapped out, all information concerning the job is written to an allocatable file. This 
information includes the job field length, control point area, dayfile buffer, dayfile pseudo FET, FNT entries 
assigned to the control point, and entries in the PP event stack and delay stack. Both the control point and 
central memory are released and made available for reassignment. The JDT is placed in the appropriate 
queue; it contains a pointer to the swap file containing the job. The job, when swapped in, may be assigned 
a different control point and a different area in central memory. 

The scheduler can be initiated by a PP program using a M.SCH or M.ICE monitor request. The scheduler is 
called in the following cases: 

1 . When a PP program has an entry to be added to the central memory queue, the scheduler will determine 
if the job has a priority high enough to cause any programs to be swapped out. If so, the scheduler 
initiates the swap-out and assigns the job to a control point. Otherwise, the scheduler adds the entry to 
the central memory queue. 

2. When the field length of a job executing at a control point is reduced, the scheduler is called to search 
the central memory queue for a new job to be scheduled. 

3. The scheduler is called periodically to determine if any job assigned to a control point has completed its 
quantum time period for CP and/or PP and if any jobs in the central memory queue have been aged 
enough to cause a swap-out. A job will be swapped out during its quantum time period only if a job 
with a very high class priority entered the central memory queue. 
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JOB CONTROL AREA 

Jobs entering the system for execution are placed into one of five classes: 

1 . Batch jobs using no non-allocatable resources 

2. Batch jobs using one or more non-allocatable resources 

3. INTERCOM (interactive) jobs 

4. Multi-user jobs 

5. Express jobs (for which operator has entered DROP, KILL or RERUN) 

An entry for each job class appears in a CMR table called the job control area. Each entry contains 
parameters affecting the scheduling of jobs in that class. These parameters include: 

Minimum class priority 

Maximum class priority 

Aging rate (time) for incrementing job priority 

Quantum priority value 

Quantum time length value 

Pointer to first JDT in job class scheduling chain 

When a job is swapped out, it is given a queue priority value equal to the minimum queue priority for its 
class. This value is incremented with time at the aging rate for the class. When the incremented priority 
value reaches that of the maximum queue priority for the class, aging stops. 

When a job is swapped in, it is given a queue priority value equal to the quantum priority for the class. 
When the quantum time length for the class has elapsed, the job priority is set to the minimum priority for 
the class. 

A system operator can control job swapping overhead by adjusting the quantum time lengths for the 
different job classes in the job control area. Special DSD commands and displays allow the operator to 
adjust the job control area parameters. 

The pointer to the job control area is T.SCHJCA which is in byte C.JCA of word P.SCH of the CMR 
pointer area. The following is the format of the job control area. 
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JOB CONTROL AREA 



59 



47 



35 



23 



17 



11 



Input 
Queue 
Entry 



Class 1 



(No 

Non-allocatable 

Devices) 



Class 2 

(Non-allocatable 
Devices) 



Class 3 

(Interactive 
Jobs) 



Class 4 

(Multi-user 
Jobs) 



Class 5 

(Express 
Jobs) 



C.JCMXB 

Max # Class 

1 Batch 


C.JCMTB 

Max # Class 

2 Batch 


C.JCCLK 
1 IB Flag 


C.JCQP 

Quantum 

Priority 


C.JCBQ 

Quantum 

Value 


C.JCCNB 

Current # 

Class 1 Batch 


C.JCCTB 

Current* 
Class 2 Batch 


C.JCPRF 

# Fixed Priority 

Jobs in Input 


C.JCEMC 

# Empty FNT 

Entries 


C.JCNJI 

# Ready Jobs in 

Input Queue 


C.JCMIN 

Minimum 

Class Priority 


C.JCMAX 

Maximum 

Class Priority 


C.JCAR 
Again Rate 


C.JCQP 

Quantum 

Priority 


C.JCBQ 

Quantum 

Value 




C.JCFRST 

Address of First 

JDT in Chain 


C.JCMIN 


C.JCMAX 


C.JCAR 


C.JCQP 


C.JCBQ 




C.JCFRST 


C.JCMIN 


C.JCMAX 


C.JCAR 


C.JCQP 


C.JCBQ 




C.JCFRST 


C.JCMIN 


C.JCMAX 


C.JCAR 


C.JCQP 


C.JCBQ 




C.JCFRST 


C.JCMIN 


C.JCMAX 


C.JCAR 


C.JCQP 


C.JCBQ 




C.JCFRST 
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JOB DESCRIPTOR TABLE 

Each job to be scheduled for execution, has a job descriptor table (JDT) entry containing information 
pertinent to its scheduling. If a job is not active at a control point, its JDT must be in one of the scheduler 
queues. Each job JDT in the CM queue is linked into one of the five job class scheduling chains originating 
in the job control area. A linking pointer to the next JDT in the chain appears in the first word of the JDT. 

Entries in one of the job class scheduling chains of the CM queue are linked in order of their entry into the 
chain. Each entry contains the time when it was added to the chain. The current priority of an entry is 
computed by multiplying the length of time the job has been in queue by the aging rate for its class and 
adding the minimum class priority. Job JDT entries in the permanent file queue are also linked; JDT 
entries in other queues are not linked. 

The job status code in the JDT is of prime importance. When a job is assigned to a control point, its JDT 
ordinal is in byte 4 of word W.CPJNAM in the control point area. If a job is not assigned to a control 
point, its status code in word W.JDMGR of the JDT indicates it to be in one of the following job 
scheduling queues: 

Central Memory Queue 

Device Queue 

Permanent File Queue 

Operator Action Queue 

INTERCOM Queue 

Format of a JDT entry: 



59 



W.JDNAM 
W.JDLNK 



W.JDSWP 



W.JDDSD 



W.JDMGR 



WJDINT 



47 



35 



C.JDEQC 
Equipment Code 



C.JDCPN 
CP# Priority 



C.JDJST 
Job St. Class 



C.JDID 

INTERCOM 

User ID 



23 



17 



Job Name 



C.JDFRB 
First RBT 



C.JDORD 
J.D. Ordinal 



1 

C.JDPFM 
PFM I 
Bits 



C.JDCPT 
CPU Time 



11 



C.JDFLG 
Flags 



C.JDTL 
Time Limit 



C.JDTIN 
Time into Chain 



C.JDIUTA 



C.JDLNK 

Link to Next JDT 

in Chain 



C.JDFL 
FL/100B 



C.JDOPF 
Operator Flags 



C.JDBP 
Base Prioritv 



User Table 
Address 



C.JDPFL 
Positive FL 



1 

C.JDORG 
SSW Origin 



C.JDRU 
PP/CP Time 



C.JDLPFL 

Length of 

Positive FL/100B 
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JDT FIELD DESCRIPTORS 

W.JDLNK 
Bits 00-17 



Bit 17-59 
W.JDSWP 

C.JDEQC, C.JDFRB 

C.JDFLG 
Bit 11 
Bit 10 
Bit 09 



Bit 08 



Bit 07 



Contain address of next job descriptor in the chain. (C.JCFRST in 
JCA points to first entry in chain; a zero field denotes last entry in 
chain) 

Job name as found in job input FNT 



Contain the swap file address (F.JDSWI in word W.JDMGR is set) 



S.JDBCB 

S.JDNRR 

S.JDLGI 

S.JDLGO 



S.JDNJ 



Set if recovery took place 

Set if job cannot be rerun 

Set if job is a LOGIN 
command 

Set if no swap file is to be 
generated for this 
INTERCOM job 
(LOGOUT command) 

Set to indicate control cards 

must be 

read from INTERCOM area 



Bit 06 
Bit 05 

Bit 04 

Bit 03 

Bit 02 
Bit 01 
Bit 00 



S.JDECS 
S.JDSKFL 

S.JDROLL 

S.JDNFNT 



Set if swap file is on ECS 

Set if FL is to be skipped 
on swap file 

Set if job cannot be 
swapped out 

Set if 1AJ should not search 
FNT table 

unused 

unused 

unused 
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C.JDFL 

C.JDPFL 

W.JDDSD 
C.JDCPN 





C.JDTL 




C.JDORD 




C.JDOPF 


Bits 09-11 


Bit 08-07 


Bit 


06 


Bit 


05 


Bit 


04 



Contains the job FL/100, including the job control block which is 
created when job is swapped out 

Contains the relative starting address/ 100 of the job control block 
when present for job swapping; otherwise, contains zero. 



Contains control point number in upper 6 bits. (Set when job is in 
execution or rolled out.) In lower 6 bits, job urgency or rerun 
priority. 

Contains job time limit as typed in by operator (truncated to 12 bits) 

Contains job descriptor (JDT) ordinal 

Contains flags set by operator 



S.JDEXP 

S.JDGO 

S.JDNS 



Bit 03 




S.JDLOK 


Bits 00-02 




Error codes: F.JDKILL, F 


C.JDORG 




Bits 06- 


11: 


Sense switches 


Bit 11 




S.JDINT 


Bit 10 




S.JDMUJ 


Bit 09 




S.JDGR 


Bit 08 




S.JDRT 


Bits 00-05 




Currently not used 



Currently not used 

If job is to be placed in 
express queue 

If operator typed GO 

If job must not be swapped 
out or rolled out 
when at a control point 

If job must not be brought 
to control point 



Set for a standard 
INTERCOM job 

Set for a multi-user job 

Set for a graphics job 

Set for a real time job 
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W.JDMGR 




C.JDJST 




Bits 48-53 


Coi 


05 


F.JDEXP 


04 


F.JDMUJ 


03 


F.JDINT 


02 


F.JDBNA 



01 



Contain the job class values 



F.JDBAT 



If express handling was 
requested for this job 

For multi-user job 

For standard INTERCOM 
job 

For batch job with non- 
allocatable device 
requirements 

For batch job with no non- 
allocatable device 
requirements 



Bits 54-59 



Ox 



lx 



2x 



3x 



4x 



5x 



Values describe the job status. 
F.JDLMB 



F.JDWCM 



F.JDWPF 



F.JDWDA 



F.JDWOA 



F.JDWIA 



If job is waiting for entry 
in a scheduling structure 
(in limbo) 

If job is waiting for CM (in 
CM queue) 

If job is waiting for a 
permanent file 
availablility (in permanent 
file queue) 

If job is waiting for device 

assignment 

(in device queue) 

If job is waiting for 

operator action 

(in operator action queue) 

If job is waiting for 
INTERCOM action 
(in INTERCOM queue) 
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xl 



x2 



x3 



x6 



F.JDSWI If job is waiting for swap 

in (is swapped out) 

F.JDACT If job is currently executing 

at a control 
point (is active) 

F.JDWCC If job is waiting for 

scheduler action 
(queue action completed) 

If job is swapped/rolled out 



C.JDPFM 

Bits 42-47 
C.JDTIN 
Bits 24-41 

C.JDBP 
C.JDRU 



Contain information used by permanent file manager 



Contain the time at which job descriptor was attached to job class 
chain 

Contains job base priority 

Contains ratio of PPU time and CPU time used by job during its last 
execution 



W.JDINT 

(assembled if INTERCOM is installed as part of the SCOPE 3.4 system) 
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JOB SCHEDULING QUEUES 

CENTRAL MEMORY QUEUE 

The CM queue is made up of jobs waiting for central memory and control point assignment. They are 
rolled/swapped jobs waiting to be reassigned a control point and/or central memory. 

The PP routine 1 IB scans the job input queue for jobs to be assigned to a control point. When such a job is 
found, 1IB creates the JDT entry and requests scheduler to set the entry in the CM queue. Jobs in other 
scheduling queues, such as the permanent file queue, for which requested action has been completed also 
are eligible to re-enter the CM queue. 

DEVICE QUEUE 

If a job executing at a control point requests a tape that must be mounted, the REQ routine will put the 
JDT into the device queue and call a swapper to roll out the job. The PP program ITS is responsible for 
detecting when the requested device is ready and for calling the PP program IDM to put the JDT entry 
back into the CM queue. When the job is rolled back in, REQ will be recalled to create a FNT entry for the 
file. 

Pseudo channel CH.SCH is used as an interlock in the device queue. Jobs in the queue are rolled out rather 
than swapped out so that the message to the operator will appear on the B display. 

PERMANENT FILE QUEUE 

When a job executing at a control point makes an ATTACH request for a permanent file, the PP routine 
PFA is called. If PFA determines that the file cannot be attached and that the job will have to wait, it places 
the JDT entry into the permanent file queue and calls a swapper to swap out the job. 

Whenever an attached permanent file is detached, 1PF is called. It checks the permanent file queue for jobs 
waiting for the detached file. If any exist, 1PF will select the highest priority waiting for the file and call the 
scheduler to put its JDT back into the CM queue. When the job is swapped back in, PFA will be called to 
attach the permanent file to the job. 

If a permanent file is purged, the PURGE routine will search the permanent file queue and call the 
scheduler to put all jobs waiting for that file back into the CM queue. As each job is swapped in, PFA will 
be called. It will detect that the file has been purged and respond accordingly. 

All entries in the permanent file queue waiting for a given permanent file will be linked together in order 
of priority. The APF table entry for the file will contain a pointer to the first JDT entry in the chain. When 
PFA adds an entry to a chain in the queue, it will age all entries in the chain and insert the new entry. 
Pseudo channel CH.PFM will be used to interlock the queue. 

If a job requests a permanent file to be attached with read-only permission and the requested file is already 
attached to a job with multi-read access, the requesting job can attach the file only if it has a higher priority 
than any job in the permanent file queue waiting to attach the file. 
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OPERATOR ACTION QUEUE 

When a job makes an operator action request, its pause bit is set in the control point area, its JDT entry is 
placed into the operator action queue, and then it is rolled out. Such jobs are rolled out rather than swapped 
out, so that the message to the operator will appear on the B display. Whenever the scheduler finds a job 
pause bit set, it calls a swapper to put the job in the operator action queue, unless the PP routine processing 
the request indicates the job is to be put into some other queue. For example, REQ will set the pause bit 
and then request the job to be put into the device queue rather than the operator action queue. 

When the operator takes appropriate action, the job is again eligible for the CM queue; it will be rolled in 
and initiated at its control point. 

INTERCOM QUEUE 

Jobs waiting for input from an interactive INTERCOM terminal or waiting until output can be sent to a 
terminal are swapped out and put into the INTERCOM queue. 

JOB ADVANCING 

When the scheduler has set up a job at a control point, the job advancing routine 1 AJ is called into a PP. 
1AJ reads one PRU of data from the control card record of the job's INPUT file into the control card 
buffer in the control point area, starting at location W.CPAF. Since the file INPUT is on an allocatable 
device, one PRU will be 100 CM words long and will extend to location W.CPCAL in the control point 
area. If the control card record has more than one PRU, 1AJ stores the INPUT file FST entry for the next 
PRU of the control card record in word W.CPFST in the control point area. 

The job card has been processed by the routine 2TJ; 1AJ scans the control card buffer for the card 
following the JOB card. When it is found, 1AJ sets a pointer in word W.CPCC of the control point area to 
the next control card and then processes the first card found. The processing sequence for control cards is 
illustrated in figure 7-1 . 

When the first control card has been processed, 1AJ is loaded again. Using the next-control-card pointer, it 
will read that card from the buffer, delineate the next card, set the pointer to the next card, and then process 
the control card just read. When all cards in the buffer are processed, 1AJ reads another PRU from the 
INPUT file control card record into the buffer and resets the next-control-card pointer to the beginning of 
the buffer. 

1AJ continues to process control cards until all have been processed, the job is terminated because of error, 
or an EXIT card is encountered. 
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CONTROL CARD PROCESSING 

When 1AJ begins to process a control card in the control point buffer, it copies the card to the job field 
length, at locations RA + 70 through RA + 77. Parameters on the control card are stored one in each word, 
starting at RA + 2. 1AJ places the control card verb in PP direct cells ELM through ELM + 4. 

1 AJ searches a table of control card names to match the verb. If the name is found, 1AJ jumps to a routine 
to process the card or calls a PP program to complete the processing. If the verb is not found in the table, 
1AJ jumps to a separate routine to search the file name table for a matching file name then to search the 
program name table for matching absolute (NUCLEUS) library program name. If the verb is the name of 
an attached local file in the job FNT, 1AJ calls the loader to load the file. If the verb is the name of a 
system program, such as COMPASS, the program is loaded by 1AJ and the CPU requested. 

Control cards with verbs in the list of control cards in 1 AJ are processed as follows: 



COMMENT 



MAP 



MODE 



LIMIT 



The comment card, less the keyword COMMENT, is issued as a dayfile message. If the 
message is longer than 40 characters, it is issued in two parts. 

The map option bits in the loader flag byte C.CPLM in word W.CPLDR1 in the 
control point area are set. 

The exit mode is set as specified on the MODE card. If the mode value is greater than 
7, a control card error message is issued. 

This card sets a limit on the amount of mass storage that can be allocated to the job. 
The value is given as a decimal number of 4096 CM-word blocks and is stored in the 
control point area, word W.CPMSLM, as the mass storage limit in number of PRUs. 
If the job does not contain this card, an installation defined value is used. A running 
PRU count is kept in the same control point word; if the limit is exceeded, the job is 
terminated. 



SWITCH 



REDUCE 



The parameter value causes a corresponding bit to be set in the C.CPSSW byte of 
word W.SSW in the control point area. 

The reduce flag is set in the loader flag byte C.CPLR of the control point area word 
W.CPLDR1. 



RFL 



The new field length value is set in byte C.CPNFL of word W.CPCC. The new field 
length must not exceed the field length given on the job card. 
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Call 1EJ 
into this PP 



Yes 




Get Next 

Control 

Card 



Yes 



EXIT 
Card 



No 



Call RPV 
For User 
Cleanup 



Yes 



Error 
Flag On 



No 

Control 

Card 
in Table 

No 



Yes 



Process 

Control 

Card 



Call PP 


Program 


Yes^- 


s' PP ^\ 

Call 
? 

[No 


Process Call 














Issue Stack Request 

to Read Absolute 

Library and 

Request CPU 






' 


' 






Drop this PP 













Figure 7-1 . Control Card Processing Flowchart 
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CATALOG 
ATTACH 

EXTEND 
RENAME 
PURGE, etc. 

RPACK 



REMOVE 



EXIT 



VSN 



DMP 



Each permanent file control card is copied into the job field length, starting at RA + 70. 
No dayfile message for the cards is issued. A CM program PFCCP is loaded to process 
the card. 



The family pack name is placed in the PP direct cell D.BA, the visual identifier and 
label type parameters are placed into D. FIRST and D.FNT. PP routine IDA is called 
to process the parameters. 

The local file name is placed in the PP direct cell D.BA; if present, the family pack 
name is left in D.EST. The PP routine 5DA is called to process the request. 

The exit flag bit is in byte C.CPFP of word W.CPFP in the control point area. If a 
control card error occurs or if a binary deck containing fatal assembly or compilation 
errors is loaded, the abort flag bit in the same byte is set. If the EXIT card contains a 
parameter, the exit flag bit is set when the error flag in byte C.CPEF of word W.CPEF 
of the control point area is set. If the EXIT card does not contain a parameter, the exit 
flag bit is set only if the error flag is set and the abort bit is not set. The PP routine 
1EJ is called to do end-of-job processing. 

The ordered sets of parameter are placed into RA + 2 throught RA + n-1. The PP 
overlay VSN is called to process the parameters from the VSN card. 

The arguments are converted to binary and the PP routine DMP is called to process 
the request. 
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JOB TERMINATION 
NORMAL TERMINATION 

Normal job termination occurs when the error flag value is zero, and all control cards for the job have been 
processed (an end-of-record mark for the control card record on the job INPUT file has been read) or when 
an EXIT or EXIT(S) card has been encountered. The end-of-job processor, 1EJ, is called by 1AJ to termi- 
nate the job as follows: 

1 . Dispose of all files associated with the job as follows: 

Drop local files and all equipment or storage associated with them. 

Attach non-zero disposition files to control point zero for further processing of output files. 

Call overlay IPC for disposal of permanent files. 

Update the TAPES table; rewind and unload tapes as appropriate. 

When tape scheduling is used, return reserved tapes to the system pool. 

2. Transfer the job dayfile to the OUTPUT file associated with the job. 

3. Release storage for the job, set the job name to NEXT (or to zero if the clear bit is set), and zero 
appropriate words in the control point area. 

Files are disposed of as follows: 

FAMILY DISK PACK FILES 

This type of private file is disposed of before any others. Information, such as file name and the RBT chain 
for the file is written to the disk pack. The file, itself, remains on the pack, but the FNT entries for both file 
and pack are deleted. RBT chains for disk pack files are released. 1EJ also calls IDA to the control point 
while it flashes a message to the operator on the B display indicating the released packs. IDA keeps 
recalling itself until the operator acknowledges the message by typing n.DROP. 1EJ then is called back to 
change the job name at the control point to NEXT if the clear flag is not set. 

PERMANENT FILES 

Each time a permanent file is to be disposed of, an entry is made in a list to be processed by IPC. IPC will 
delete the FNT/FST entry for the file; normally, the file will still exist on a mass storage device, unless 
purged by the user/owner. The APF entry for the file will be updated or deleted, as appropriate. 
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INPUT FILE 

The job input file is not dropped until after the dayfile has been transferred to the job OUTPUT file and 
the OUTPUT file has been released to JANUS. Then the disk space for the job input file is evicted and its 
FNT/FST is cleared. 



OUTPUT FILE 

At the start of 1EJ operation, the buffer of all output files are flushed. After the dayfile has been copied to 
the job OUTPUT file, the OUTPUT file FNT is modified so that the file name is replaced by the job name, 
and the file is assigned to control point zero and rewound. The file is then released for processing by 
JANUS. 

If the output file is on a non-allocatable device or pack, the equipment is dropped and the FNT is zeroed 
because JANUS cannot process files on non-allocatable devices. 

If the file is on an allocatable device, the output buffers are flushed, the FNT is rewritten so that the file 
name is replaced by the job name, and the file is assigned to control point zero and rewound; its disposition 
code is retained. For INTERCOM batch files, the user ID is picked up from the control point area and 
stored in the FNT. 



OTHER LOCAL FILES 

If the file is on a non-allocatable device, the equipment is dropped. If the file is on an allocatable device, the 
file space is evicted. In either case, the FNT/FST entry is cleared. 

DAYFILE 

After the dayfile has been copied to the job OUTPUT file, its FET is reset. If part of the dayfile is on disk, 
the disk space is released. The FNT is rewritten to make the file local to control point zero, and the FST is 
cleared. 
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ABNORMAL TERMINATION 

Abnormal termination of a job occurs when error flag value is non-zero. If the error flag value is other than 
KILL (value 7) or RERUN (value 10), 1EJ will dump the contents of the exchange package and the 
contents of memory. The dump includes location 100 before the error stop location through 100 words 
after the location (P-100 to P+ 100) to the OUTPUT file. A dayfile message describes the error. If an error 
flag value other than KILL or RERUN occurs and an EXIT or EXIT(S) card is contained in the job, the 
preceding will occur in addition to the flushing of output buffers for files with non-zero disposition codes. 
1EJ then calls 1AJ to process the control cards appearing after the EXIT card. 

If the operator has killed the job, the error flag value is set to 7. Permanent files and family disk pack files 
are processed as for normal termination. The FNT is zeroed and disk space or equipment is released for all 
other files, including output and non-zero disposition files. JOB KILLED is issued to the system dayfile, the 
control point area is reset and the job name is cleared. No output is produced for killed jobs. 

If an operator has typed a RERUN command, the error flag value is set to 10 and the job input file is 
returned to the job input queue. Permanent files and family disk pack files are processed as for normal 
termination; all other files are dropped. A pre-output file is created as a local file to control point zero; it is 
not rewound; it has a file name which is the same as the job name. The dayfile is copied to the pre-output 
file, which becomes the output file for the job when it is rerun. Before dropping out, 1EJ resets the control 
point area and changes the job name to NEXT. However, if the clear request flag in byte C.CPFLG of the 
control point area is set, the job name will zeroed. 
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JOB POST-PROCESSING UTILITIES 

During execution of a user program, various errors, such as arithmetic mode error or exceeding time limit, 
may cause the program and the job to terminate abnormally. At this point, the operating system will place a 
message in the dayfile, dump the exchange package and central memory t^iOO words on each side of the 
error stop location) and either resume the job processing at an EXIT or EXIT(S) card or terminate the job. 

At the request of the user, the operating system will return control to the job after normal termination or 
after an error condition is detected and before EXIT card processing is performed. At that time, the system 
will return control to a user supplied post-processor routine which will print out data in appropriate format, 
etc. The user's post-processor routine may specify procedures to be performed after normal or abnormal job 
termination. 



REPRIEVE 

The reprieve function RPV is a PP program called by the user and by 1AJ. It allows the user to receive 
control at a location inside the job field length after program termination, at which time a cleanup /recovery 
routine may be executed. 

The user should call RECALL during the job initialization phase, at which time the RPV call, generated by 
RECALL as follows, is placed in RA + 1 : 

VFD 18/3HRPV,6/20B,12/mask,24/fwa 

RPV Is the PP routine name 

20B Sets the CPU in auto-recall 

mask Is a bit list of error classes for recovery 

f wa Is the first word address of the recovery routine in the user job 



60306500 A 7-25 



Job terminations are divided into classes; each class is assigned an octal value which may be specified singly 
or in combination to form the mask generated as part of the call. The values are: 

000 1 Arithmetic mode error 

0002 RA+ 1 error (PP call error, auto-recall error) 
0004 Time and/or storage limit exceeded 

0010 Operator drop or rerun 

0020 System abort (PP abort; ECS parity error) 

0040 CP abort 

0100 Normal termination 

The first word address points to a 17-word (decimal) block which will receive the exchange package and 
RA + 1 contents. Control is returned to fwa + 21. 

Upon a user call to RPV, if the value of the upper 30 bits of the word at fwa is non-zero, it is assumed to 
be the last word address of the recovery routine in the user's job. A checksum of the area fwa + 2 1 to lwa 
will be made and the sum stored in fwa + 1 . 

The call to RPV by 1AJ occurs when 1AJ is entered with both error flag and reprieve mask non-zero. 1AJ 
calls RPV with bit 4 1 of the input register set to one. 

Upon exit from a user call to RPV, the mask and fwa fields of the call will be stored in the control point 
area, in word W.CPCC. The contents of the word at fwa will be cleared; and if a checksum was performed, 
fwa + 1 will contain the sum. 

Upon normal exit from a call by 1AJ, the mask in the control point area will be cleared, the exchange 
package with the error flag set in register B0 will be in fwa to fwa + 17, and the contents of RA+ 1 will be 
in the next word, fwa + 20. If the remaining central processing time is less than five seconds and no time 
extensions have been grated, the time limit will be extended an additional five seconds in order to perform 
the user's recovery routine. 
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RECOVR 

The central memory program RECOVR is an interface between user program and operating system for 
users who wish to gain control at the end of a job step, regardless of the manner in which it terminated. 
RECOVR should be called 'during the initialization phase of the job, at which time the address of the post- 
processing routine is given. RECOVR formats the arguments in the call into a stack entry, checksums the 
user post-processor routine if requested, saves the checksum in the stack, and then calls the PP program 
RPV to inform the system that the job should be restarted in case an error occurs. 

When the system detects an error condition, it will issue two messages to the dayfile: the first will report the 
error condition and the second will report that the job has been restarted only if flags set in RECOVR call 
match those that cause the abort. It will give control to RECOVR along with the contents of the exchange 
package and RA + 1 and the code for the condition that caused the system to stop program execution. 
RECOVR will call the post-processor program in a last in-first out order of calls in the entry stack and pass 
to it the address of the array area in which the exchange package, RA + 1 contents and system error code 
has been placed. Upon termination of the user's post-processing routine, RECOVR will make an abort 
request to the system so that EXIT card processing will follow, unless the post-processor has specified that 
the program be terminated normally. 

The calling sequences for RECOVR: 

FORTRAN: CALL RECOVR ( name, f lags .checksum) 

COMPASS: RECOVR name .flags , checksum 

name Name of the user routine to which control is returned after a 

system abort 

flags Octal value specifying condition under which control is to be 

returned. 

00 1 Arithmetic mode error 

002 RA+1 error 

004 Time/storage limit exceeded 

1 Operator drop or rerun 

020 System abort 

040 CP abort 

100 Normal termination 

checksum Should be zero for no checksumming; otherwise, it should be the 

last word address + 1 of the recovery program to be 
checksummed. 
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The user post-processing routine to which control is returned by RECOVR should provide for three argu- 
ments. ( 1 ) The address of a 1 7-word array to receive the contents of the exchange package upon abort in 
the first 16 words and the contents of RA+ 1 in the 17th word. (2) A flag to indicate normal (ENDRUN) 
termination of the job or abnormal (ABORT) termination after post-processing is completed. A non-zero 
value indicates normal termination. (3) An address of a word to contain the contents of RA + 0. If the P 
register contains zero in the exchange package, the address of the program error stop will be returned in 
bits 30-47 of RA + 0. 

Under no circumstance should the post-processor routine store into or modify the contents of the first 
argument. 

The system error code is returned in bits 0-17 of word 1 of the first argument. The octal codes are: 

Normal termination 

1 Time limit exceeded 

2 Arithmetic mode error 

3 PP abort (illegal parameter list passed to a PP) 

4 CP abort (program posted an ABORT request) 

5 PP call error (garbage in RA + 1 or PP program called is not in 
library) 

6 Operator drop 

1 Job to be rerun 

1 2 ECS parity error 

1 5 Auto-recall error 

16 Job hung in auto-recall 

Octal codes 7,1 1,13 and 14 exist but control will not be returned to the user when they occur. 

If the user program is executed in overlay mode, both the call to RECOVR and the post-processing routine 
should reside in the 0,0 level overlay. 

When the system stops normal execution because the job time limit has been exceeded, the time limit will 
be incremented by a value set per installation option so that the post-processing routine can be executed. 
Post-processing of an error condition should not be confused with OWNCODE (user processing of parity 
errors); the two concepts are not rela'ted. 
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INTRODUCTION 

The purpose of SCOPE 3.4 EDITLIB is to: 

Create deadstart tapes 

Create and maintain system libraries 

Manipulate the running system to effect temporary changes 

Modify the running system or the deadstart tape by merging in permanent changes and creating a 
new deadstart tape. 

Create and modify a user library consisting of group of central processor routines or overlays. 

The above is consistent with the philosophy of SCOPE 3.4. Assuming a user is starting from scratch, he will 
obtain an unconfigured deadstart tape from Software Distribution. This tape will contain the binary decks 
of the entire SCOPE operating system, to be used to deadstart a brand new system. EDITLIB is then called 
upon, via selected control cards and directives, to modify the current system after the appropriate assem- 
blies and compilations have been performed. Thus a new deadstart tape and/or running system may be 
created which reflects the system as it is physically configured. (See figure 8-1.) 

A major difference with previous system is that SCOPE 3.4 no longer requires all system code to be located 
in one massive system library. Object code may now reside in either a system library or a user library. Thus 
EDITLIB may be used in two distinct forms: SYSTEM EDITLIB, which is discussed in this section; and 
USER EDITLIB, which is contained in the SCOPE 3.4 Reference Manual. 
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Figure 8-1 . Basic Usage of System EDITLIB 
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CHARACTER SET 

The EDITLIB character set is that which is supported by SCOPE 3.4. EDIT/LIB will interpret the 
$ ( ) = + - * / , and . as delimiters. Blanks are free characters and will be removed. From the charac- 
ter set, the user is able to create: 

1 . Symbol — a single character or a string of characters 

2. Vocabulary Word — a symbol that has meaning as denned by the semantics. 

3. Name — a symbol that is denned by syntax and semantics. 

When any delimiter and /or a blank is used to form a symbol, the symbol must be enclosed between $ signs, 
(see Example 1). When a $ is to be used as a character within a symbol, an additional $ must be written 
immediately adjacent to each $ desired. The only character that will be removed is the first $ of each pair 
of $ encountered. (See example 2.) 

Whenever a name could be interpreted as a number or a vocabulary word, the name should be enclosed 
between $ signs. 

Examples: S--DSD— $ 

Symbol is —DSD — 

$D$$I$$$$S$--$ 
Symbol is D$I$$$-- 
SSSCIOS 
Symbol is SCIO 

The input to EDITLIB is the first 72 columns of an 80 or 90 column card image. A directive must be 
completely contained on one card. 
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SYNTAX AND SEMANTICS 

Presented here is the format of the various directives and the meaning associated with the symbols. The 
syntax as illustrated in the examples must be followed. 

Any directive having parameters must be terminated by a right parenthesis. If the directive has no parame- 
ters, it must be terminated by a period. 

Whenever a violation of syntax is encountered, EDITLIB will set the abort flag. After EDIT/LIB has 
completed a given task, such as checking all directive formats, it will check the abort flag. When set, 
EDITLIB will abort. EDITLIB will continue to check a directive even if it has located an error in that 
directive. EDITLIB will proceed to the next directive only after it has completed analyzing the current 
directive or after it is unable to determine the syntax of the directive. 



SYMBOLS USED IN SYNTAX 

[ ] The enclosed items are optional. 



1 

( ) 

P 
lfn 

n 

pn 

r 



or 

The enclosed item is the actual symbol. 

name of a routine 

Logical file name 

positive or negative integer 

library name 

residence: 



CM 
DS 
ECS 
EM 

Default 



Central Memory 

Disk 

Extended core storage; if no ECS available, then default to disk. 

Extended Core storage; if no ECS available, then Central 
Memory. 

Disk 
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Interval in a directive will be interpreted to mean 

P, + P 2 or 
P,-P 2 or 
P,/P 2 /P 3 or 
P, 

where P; are single program names. It is acceptable to replace either P, or P 2 with [*], but not both. 
EDITLIB will set the abort flag for the following conditions: 

unable to locate P, 

unable to locate P 2 

unable to locate P, when P 2 = [*] 

unable to locate P 2 when P, = [*] 

unable to locate P, when there is no interval. 

* This may be used to replace p in the syntax. When * is encountered, EDITLIB will consider all remain- 
ing routines on the file proceeding from the current position. If the file is a library, the current position 
is the first entry in the PNT. 

+ This symbol is used to designate an inclusive interval. 

Example: Given the ordered set of records A, B, C, D, E, F, and G on a file; 

then A + G represents all members of the file. 



— This symbol is used to designate an exclusive interval. 



Example: Given the ordered set of records A, B, C, D, E, F, G, H, I, and J 

on a file; then D-H represents all members of the file except D, E, 
F, G, and H. This leaves A, B, C, I, and J. 
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Notes 

1 . EDITLIB will assign a number to each directive it processes. 

2. EDITLIB will list each input card it receives on the OUTPUT file. The directive as interpreted by 
EDITLIB will appear directly below the input card. The interpreted directive will be prefaced by the 
number assigned to this directive. All comments about the directive will follow the interpreted direc- 
tive. Error messages will be generated by referencing the number that is assigned to each directive. 
Error messages will be issued whenever EDITLIB finds it cannot comply with the user's request. 
EDITLIB will also issue messages when it is unable to determine what the user is trying to accomplish. 

3. The directives ADD, DELETE and REPLACE will produce a CONTENT directive on the routines 
involved. 

4. Any interval specified in a directive will be interpreted to mean: 

In a reference to a file which is a library, the interval will be formed by the entries in the order 
they appear in the Program Name Table. 

In a reference to a file that is not a library, the interval will be formed by the order of the routines 
on the file. 

The interval begins when p, is encountered and ends at which ever occurs first: p2 or EOF or the last 
entry in the PNT. The table or file is not handled circularly. 

5. In a System EDITLIB, all directives that do not specifically name a particular library and are not 
contained between a LIBRARY and FINISH directive will refer to the PP library. This means that the 
PP library is the default library when no library is specified. 

6. EDITLIB will not support TEXT and/or DATA input (7000 LIBEDT). If text/data input is found, it 
will be flagged and the job will be aborted. 

7. Miscellaneous 7000 LIBEDT directives: TYPE, ERROR, PCOPY, PMOVE, MOVEC, COPYC, and 
DELETEC. 6000 EDITLIB will ignore these, print a warning message on each directive, and send one 
warning message to the dayfile, if present in run. 
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SYSTEM EDITLIB 

EDITLIB FILES 

EDITLIB will use the following lfn: 



Ifn 


Cataloged 


ZZZZZ01 


yes 


ZZZZZ02 


yes 


ZZZZZ03 


yes 


ZZZZZ04 


yes 


ZZZZZ05 


no 


ZZZZZ06 


no 


ZZZZZ07 


no 


ZZZZZ08 


no 


ZZZZZIO 


no 


ZZZZZ11 


no 


ZZZZZ12 


no 


ZZZZZ13 


no 


ZZZZZ14 


no 


ZZZZZ15 


no 


ZZZZZ16 


no 


ZZZZZ23 


yes 



Use 

RESET 

RESTORE 

SYSTEM EXTEND 

SYSTEM 

Interpreted directives 

ECS resident routines library file 

Entry Point Name Table spill file 

Entry Point Name Table spill file 

Program Name Table spill file 

External Reference Table spill file 

External Reference Collection spill file 

Library or Deadstart program collection 

Scratch 

PP Program Name Table spill file 

Library Name Table spill file 

Current Directory File 



60306500 A 



8-7 



System EDITLIB will produce the following type of files: 



File Use 


Ifn 


pfn 


RESET 


ZZZZZ01 


ZZZZZ01 


RESTORE 


ZZZZZ02 


ZZZZZ02 


SYSTEM EXTEND 


ZZZZZ03 


ZZZZZ03 


SYSTEM 


ZZZZZ04 


ZZZZZ04 


ECS LIBRARY 


ZZZZZ06 




Current Directory 


ZZZZZ23 


ZZZZZ23 



The files will be cataloged using the following keys: 



File Use 


ID 


RP 


TK 


CN 


MD 


EX 


RESET 


EDITLIB 


999 


SSSSSSSSS 


XNOX 


XNOX 




RESTORE 


EDITLIB 


999 


SSSSSSSST 








SYSTEM EXTEND 


SYSTEM 


999 


SSSSSSSSU 


XNOX 


XNOX 


XNOX 


SYSTEM 


SYSTEM 


999 


SSSSSSSSV 


XNOX 


XNOX 


XNOX 


Current Directory 


SYSTEM 


999 


DIRECTORY 


XNOX 


XNOX 





In SCOPE 3.4, the allocation of ECS is controlled by Monitor. Since the allocation of ECS involves the 
creation of tables and pointers by Monitor, the Deadstart Loader will not duplicate this effort to set up ECS 
files. Due to this change, a new procedure will be required to place routines into ECS at initial deadstart 
time. 

Another task that EDITLIB performs in conjunction with deadstart is that of recorery. Deadstart will call 
EDITLIB to accomplish a C type recovery. In this situation, no operator intervention is required. The 
Deadstart Loader will set bit S.SYSEDT in byte C.DSFLAG in word P.LIB. This bit when set informs MDI 
that it can go ahead and change the directory without issuing the GO/DROP message. When MDI has 
moved the directory from the CP to CMR, it will clear S.SYSEDT and set bit S.EDTRUN in the same byte. 
S.EDTRUN will be set by EDITLIB whenever the directory is changed. 

EDITLIB will also maintain a permanent file (ZZZZZ23) for the Deadstart Loader. This file will contain 
the current system directory. This record represents the directory as it appears in CMR. 
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The files ZZZZZ01, ZZZZZ03, ZZZZZ04, ZZZZZ06, and ZZZZZ23 will be cataloged such that by attach- 
ing them, CN (Control) and MD (Modify) permission are not granted. That is. the above permission will 
be granted if the correct passwords are specified, but not by just specifying the ID (Identification) and TK 
(Turnkey). EDITLIB will request the CN or MD options on file ZZZZZ23. When EDITLIB modifies the 
running system, it will do so by adding the new routines to the end of the file called ZZZZZ03. By using 
this method, EDITLIB will not keep others from accessing the files. 



CONTROL CARDS 
PROGRAM CALL CARD 



EDITLIB(SYSTEM,t,,t 2 , 

where tj can be 



■t„) 



RESET 
RESTORE 
I = lfn 
L = lfn 
LDIS 
MSGL=n 



SYSTEM 



RESET 



RESTORE 



This parameter is a password. It is used by EDITLIB to determine what kind of 
EDITLIB run is to be performed. This key is a program parameter. The key can not 
exceed nine characters and will allow restricted access to the running system directory. 

This parameter instructs EDITLIB to replace the current system directory with the 
directory as it appeared after initial deadstart. Whenever the RESET parameter is 
encountered, EDITLIB will use the directory from the RESET permanent file to re- 
place the directory presently in CMR. It will then change this directory as prescribed 
by the directives in the input file. EDITLIB will then replace the current directory 
with the directory it just modified. A copy of the current directory will be saved on 
the RESTORE permanent file before the change takes place. 

This parameter informs EDITLIB that a user wishes to replace the current system 
directory with the directory as it appeared before the last EDITLIB took place. When- 
ever the RESTORE parameter is encountered, EDITLIB will use the directory on the 
RESTORE permanent file to replace the directory presently in CMR. The reset of the 
procedure EDITLIB follows is the same as for an EDITLIB (SYSTEM, RESET) except 
that the current directory will not be saved on the RESTORE file. 
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I = lfn This symbol is used to designate the file containing EDITLIB directives. If it is not 

present, the lfn that will be used is INPUT. If INPUT is used, any binary input to 
EDITLIB on this file must be in the order that it will be requested. This file will not be 
searched. 

L = lfn This symbol is used to designate the file of listable output from EDITLIB. If it is not 

present, the lfn that will be used is OUTPUT. 

LDIS This is a decommittal request to EDITLIB to issue a message to the dayfile to have the 

operator bring the L display to this control point. The message issued will be EDITLIB 
REQUEST L-DISPLAY. This parameter will allow the operator to enter EDITLIB 
directives from the display console. If this option is selected, directives from the con- 
sole will be accepted before those in the input file. Each directive entered at the key- 
board will be placed, in turn, in the user's field length and analyzed for syntax. The 
user may not enter directives until the word NEXT, is displayed. The word WAIT, will 
be displayed when EDITLIB is processing a type-in. 

MSGL = n where n = or 1. The default value is 0. Under this condition all EDITLIB messages 

will be sent to the output file only. If n= 1, EDITLIB will send its messages to the 
output file and to the system and user's dayfile. Thus all messages will appear on the 
system A display. If the value of MSGL is 0, then all error messages, including fatal 
error messages, will only appear in the output listing. 

OPTIONAL PARAMETERS 

Optional parameters are not positional. 

AL = 1 where 1 = to 7777B. Default = 0. AL stands for access level and is a parameter of 

the ADD and REPLACE directives. 1 1 of the 12 bits are meaningful to INTERCOM 
only. The right most bit of this field is used by the system to regulate access to pro- 
gram through control card requests. When this bit is set to 0, the routine or entry 
cannot be called from a control card. The setting of this 12-bit field is determined by 
the binary representation of the octal digits specified by AL. INTERCOM has divided 
the 12-bit field into 3 sections. The first section is one bit in size and is the right most 
bit of the field. The remaining 1 1 bits are divided into two sections according to the 
installation parameter, IP.ACES. IP.ACES = n defines the number of bits to be re- 
served for the access level. The remaining bits (1 1-n) will be used as permission bits. 
When a user requests the use of a command, his access level is checked to determine 
whether it is greater than or equal to the access level of the command. 

If it is, the permission bits of the user are compared against the permission bit of the 
command. If a match is found, the user is given access to the command. If either test 
fails, permission is not granted. 
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FL = k 



FLO = m 



LIB = pn 



NEW 



OLD 



where k = 0-377777. Default = 0. FL is a parameter of the ADD and REPLACE 
directives and stands for Field Length. It is meaningful for CM programs only. It is 
used by INTERCOM to determine the amount of CM needed to execute a program. 
This field length must taken into account the CM needed by all programs, overlays and 
segments that could be loaded by the specified program. 

where m = or 1. Default = 0. This parameter can only appear on an ADD or 
REPLACE directive. It is used to set the FL override bit. This bit is used by INTER- 
COM to determine whether the field length entered by the user at a terminal may 
override the field length specified in the PNT. 

where pn is the name of a library. This is a parameter which can only appear on an 
ADD or REPLACE directive. It is used when the lfn specified in the directive is 
SYSTEM (meaning the running system) or a deadstart file. This parameter specifies 
what library on the deadstart file will be used to satisfy the directive. 

Mandatory parameter for the LIBRARY directive and optional parameter for the 
READY directive. When a deadstart file is being created, the lfn specified will contain 
a new library or directory. 

Mandatory parameter for the LIBRARY directive and optional parameter for the 
READY directive. It is required in these directives when an existing library or an 
existing deadstart file is referenced by the lfn parameters. 

Represents residency as follows: 

CM Central Memory 



ECS 
DS 

EM 



Extended Core Storage: if no ECS available, then default to disk. 

Disk (default) 

Extended Core Storage; if no ECS available, then Central 
Memory. 



Examples: 



EDITLIB(SYSTEM) 
EDITLIB(SYSTEM. RESET) 
EDITLIB(SYSTEM.LDIS.MSGL=1. RESTORE) 
EDITLIB(SYSTEM.LDIS.I = INFILE,MSGL = 0) 
EDITLIB(SYSTEM.I = INFILE.L = OUTFILE) 
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DIRECTIVES 

ADD(Interval,lfn[,r][,(AL = ) l ][,(FL = )k][,(LIB = )pn][,(FLO = )m]) 

This directive adds the specified program(s) from the lfn to the library under construction or modification. 
If the lfn contains a library, the Program Name Table of the library will be searched to locate the specified 
program(s) to be added. If the file is not a library, the search for the specified program(s) will begin at the 
current record position on the file and proceed to EOF. If the program(s) are not found, the file will be 
rewound and the search will continue until all programs have been searched. If the program(s) are not 
found in the library or on the file, an error message will be issued. If the program(s) to be added already 
exist(s) in the library, an error message will be issued. It is not the function of an ADD directive to replace 
the current program with the new program. This function is accomplished by a REPLACE directive. 

Example: ADD(HIGH,LOW,ECS,AL = 70,FL= 1000) 

ADD(HIGH,LOW,FLO = 1 ) 

ADD(HIGH,SYSTEM,LIB = SCOPE,ECS,AL =123) 
CHANGE(pn[,r]) 

This directive is used to change the residence of a library. If the library already has the specified residency 
or if the library is not part of the system, EDITLIB will issue an appropriate comment. 

Example: CHANGE(FNT,CM) 

COMPLETE. 

This directive informs EDITLIB that the directive list for the directory whose name appeared in the 
READY directive has been exhausted. Simply, it means that there are no more modifications or additions 
to be performed on the directory. This directive must have been preceded by a READY directive. 

CONTENT(Interval,lfn) 

The CONTENT directive is used to obtain information about a program or series of programs on a 
specified file (lfn). The information is obtained from the programs expanded Prefix Table and the program 
itself. The CONTENT directive applies to all files other than a deadstart file or a LIBRARY file. 

Example: CONTENT(ONE,FILEl) 

DELETE(Interval) 

This removes all entries from the library tables that refer to the specified programs. 

Example: DELETE(FEAR) 

DELETE(FEAR + HATE) 
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END. 

This directive is a request for decommittal and designates that the last directive has been entered from the 
L-display. EDITLIB will now resume as if the LDIS option had not been requested. 

ENDRUN. 

This directive indicates that execution of directives should stop. All directives following ENDRUN will be 
checked, but not processed. This is an optional directive; if it is not found, one will be generated. If this 
directive is found and EDITLIB finds an error in a directive after the ENDRUN card, it will be flagged but 
will not cause an abort. 

FINISH. 

This directive designates the end of the list of directives that will affect the library defined by the last 
LIBRARY directive. Each LIBRARY directive must have a FINISH directive. It is permitted to have 
multiple (LIBRARY. FINISH) sequences within a single directive sequence. 

INCLUDE(pn,lfn[,r]) 

This directive will add the library which is on the specified file to the directory. This allows a user to make 
his user library a part of the running system. 

Example: INCLUDE(SMOG.AIR.ECS) 

INCLUDE(SMOKE.LUNGS) 

LIBRARY(pn.(OLD)l (NEW)(.r)) 

The LIBRARY directive during a system EDITLIB run performs two functions. When it is encountered 
outside of a READY and COMPLETE directive, the action taken is equivalent to a user's EDITLIB. When 
it is between a READY and COMPLETE directive, the action is also equivalent to that of a user's 
EDITLIB. but the LIBRARY will be found using the Library Name Table (OLD) or will be added to the 
Library Name Table (NEW). 

Example: LIBRARY) FTN.OLD) 

LIBRARY* RUN.NEW.ECS) 

LIBRARY(COBOL.NEW) 
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LISTLIB(Interval,lfn,[pn]) 

The LISTLIB directive is used to list a library which can be a user's library, running system, new system 
and /or deadstart file. 

Note: LISTLIB(COPY,SYSTEM,SCOPE) 

When between READY and COMPLETE, the lfn that the list will be performed on is the running system 
and/or the new system under construction. When this directive appears outside of a READY and COM- 
PLETE, only a user's library and a deadstart tape can be listed, pn is meaningful when listing the running 
system, new system or deadstart file. If not present, the PPLIB is assumed. LISTLIB cannot be present 
between a LIBRARY and a FINISH directive. 

These directives will send information about the specified program(s) on the lfn or on the lfn and in the pn 
to the output file. The information will come from the object deck being processed. 

Example: LISTLIB(COPY,FILE 1 ,SCOPE) 

LISTLIB( 1 AJ,S YSTEM) 

LISTLNT. 

The LISTLNT directive must appear between a READY and a COMPLETE directive. It will list the 
Library Name Table of the file referenced on the READY directive. There are no parameters. 

MOVE(Interval,r) 

This directive will change the residence of CP programs within a system library. Movement of CP pro- 
grams depends on the residence of the system library of which the CP program is a part. If CM resident, 
movement is unrestricted; but for DS and ECS resident libraries, the new residence can be specified only as 
DS or ECS. 

Example: MOVE(STOCKS,DS) 

MOVE(BONDS + CASH,CM) 
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READY(lfn [,(OLD) 1 (NEW)] ) 

This is the first directive of any directive list pertaining to the lfn specified. Only those directives between a 
READY and a COMPLETE will affect the lfn. The READY directive is used in conjunction with a system 
EDITLIB run. The READY directive specifies that the operation will be performed on a directory. The lfn 
is either the running system or the name of the file which will contain the new system. If the name 
SYSTEM appears as the lfn, it will mean the running system when the OLD parameter is specified or 
missing. Directives following the READY directive can be classified into four major functions: Those that 
modify the Library Name Table; those that modify the PP library; those that modify the system library 
(they must have LIBRARY and FINISH directives to delimit them); those that do not change any part of 
the system directory. 

Examples: READY(FUTURE,NEW) READY(FUTURE) 

READY(SYSTEM,OLD) READY(SYSTEM) 

REMOVE(pn) 

This directive removes the library from the running system. The library's entry in the Library Name Table 
is removed. 

Example: REMOVE(FTN) 

REPLACE(Interval,lfn[,r] [,(AL =)1] [,(FL =)k] [,(LIB =) pn ] [,(LFO =)m]) 

This REPLACE directive in a system EDITLIB will retain the r value of the replaced routine if r was not 
specified. All other option parameter values will not be saved. 

Example: REPLACE(IBM,CDC,AL = 70) 

REPLACE(XDS-RCS,NCR,LIB = NUCLEUS) 

REWIND(lfn) 

The result of this directive will be the positioning of the specified file at the first record on the file. To 
accomplish this, EDITLIB will issue a CIO request to do a REWIND. In system mode, the file name 
SYSTEM refers to the running system. 

SETAL(IntervalJ) 

where I = to 7777 (octal). This directive permits the user to change the access level of a program already 
in the directory. 

Example: SETAL(IBM + NCR,7770) 

SETAL(CDC,1) 
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SETFL(Interval,k) 

where k = to 377777 (octal). This directive permits the user to change the field length required to run the 
specified program already in the directory. 

Example: SETFL(BYTE, 100000) 

SETFL(BIT + WORD, 1 00000 ) 

SETFLO(Interval,k) 

where k = or 1 . This directive permits the user to change the field length override bit of program already 
in the library. The default value is (override is not permitted). 

Example: SETFLO(BIT 11,0) 

SETFLO(BYTE-WORD, 1 ) 

SKIPF/SKIPB(N,lfn,[F]x [P]) 

This is the new skip-forward and skip-backward directive. The meaning of the parameters is as follows: If 
N is numeric, it represents a number of records to be skipped unless the third parameter is present; then 
the meaning is files. If N is alphanumeric, then it means that the lfn will be positioned before the record of 
that name (N). If N is not found, original position is maintained. Alphanumeric form is applicable to 
sequential files only. While in system mode, the file name SYSTEM means the running system. 

TRANSFER(Intervall n,lfn) 

This directive is used to create deadstart tapes. It will move records whose prefix table has been removed or is to be 
removed. A check will be made to determine if the records being moved have a prefix table. Because a program name 
can be all digits it is necessary to delimit such programs for this directive; e.g. program name is 026 the directive will 
be TRANSFER($026$,SYSTEM). 

Example: TRANSFER(*,SYSTEM) 

TRANSFER( 1 0,S YSTEM) 

* /comment 

This symbol is used to denote a comment field; whenever encountered in columns one and two, EDITLIB 
treats it as a comment and will not check the card. 

Example: */THIS ADDS A PROGRAM THAT WILL DO A/B*C 
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LIBRARY DIRECTORY ACCESS 
PP ROUTINES 

When a PP routine wishes to access the library directory, it will first check bit 59 of P.LIB. When bit 59 is 
set to 1, EDITLIB is waiting to change or is changing the directory. Thus, the directory is unavailable. 
When bit 59 is set to 0, the directory is available. 

CP ROUTINES 

All CP routines accessing the directory should set bit S.CPLDAF in byte C.CPFLAG in word W.CPFLAG 
of their control point area. To access the directory the following procedure should be followed. First check 
bit 59 in P.LIB; if not set, then set bit S.CPLDAF. Then check bit 59 in P.LIB again. If it is now set, clear 
S.CPLDAF and wait until bit 59 in P.LIB is clear. After access is obtained and directory access is complete, 
clear bit S.CPLDAF. 



EDITLIB 

When EDITLIB wishes to access the directory, it will issue a monitor request to have the PP routine MDI 
assigned to its control point. By passing MDI the appropriate code. MDI will try to change the directory. 
The procedure is as follows: 

MDI will set bit 59 in P.LIB to 1 to lock out all other routines from initiating a directory access. It 
then checks bit S.CPLDAF in byte C.CPFLAG in word W.CPFLAG in each control point area. If 
the bit is set, it means the job has not completed its last directory access, and MDI will go into the 
event stack until the bit is cleared. After MDI has completed its task, it will adjust the FWA and 
the LWA+ 1 pointers in P.LIB and set bit 59 to 0. 



LIBRARY DIRECTORY POINTER FORMAT 



59 



53 



35 



29 



11 



a 




FWA of CM 
Directory 




LWA+1 of CM 
Directory 


Dead Start 
Load Flag 



a = Library Change Flag 



P.LIB 



The use of the first word has been expanded to hold a Library Change Flag (1 bit). 
This flag was added to increase system integrity and effiency. The Library Change Flag 
tells the PP and any CP program using the directory that an EDITLIB run wishes to 
change the directory or is changing the directory. Only when the flag in the control 
point areas is zero will EDITLIB proceed to change the directory. 
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PP LIBRARY POINTER FORMAT 



59 



47 



35 



23 



17 



cccc 


0000 


NNNN 


00 


FFFFFF 



P.PPLIB 



FFFFFF is the address of the first entry in the PP Program Name Table. NNNN is 
the number of entries in the PP Program Name Table. CCCC is the position of CIO in 
the PP Program Name Table. This value specifies the number of entries preceding 
CIO. 



MDI will set this word to zero and wait one second before changing the directory. 



FILES 

SYSTEM FILES 

A copy of all the routines referenced by the directory will reside on a permanent file called ZZZZZ04 after 
initial deadstart. If a program or library subsequently is to he included into the directory, it will be placed 
in the permanent file called ZZZZZ03. EDITLIB will never write, modify or extend the permanent file 
ZZZZZ04. The new version of replaced routines will reside on the file ZZZZZ03. Since EDITLIB will not 
alter any record currently on the file ZZZZZ04 or the file ZZZZZ03, routines may be read from either file 
while EDITLIB is adding new records to ZZZZZ03. 

USER FILES 

The user is responsible for the contents of his library. EDITLIB will not overwrite any record on the file. It 
will only add records at EOF/EOI. This means that the user will have unused records on his file when he 
deletes are replaces programs on his library. It is up to the user to remove this dead space by building a new 
library using the old one as a source. EDITLIB will issue no permanent file request. The user must attach, 
catalog and extend his file. If the library is on tape, the user must build a new library each time an 
EDITLIB is performed on the library, using the old library as a source. 
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GENERAL 

Index to user's libraries on a random file (six words): 

WORD ADDRESS 

1 Entry Point Name Table 

2 External Reference Table 

3 Program Number Table 

4 Program Name Table 

5 Entry Point and External Reference List 

6 Unreferenced PRU Count (not an address) 
Format of user's library on a sequential file: 

RECORD CONTENTS 

1 This record is three words long: 

1. ***LIBRARY 

2. Library Name (blank filled) 

3. Date of creation 

2 Entry Point Name Table 

3 Entry Point and External Reference List 

4 External Reference Table 

5 Program Number Table 

6 Program Name Table 

7 to EOF Routines 
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SYSTEM SECURITY 

EDITLIB will use the reprieve function to protect the system files and its scratch files. Under any normal or abnor- 
mal termination condition, EDITLIB will have control turned over to a program that will return or release all 
EDITLIB internal files. 

MDI (MOVE SYSTEM DIRECTORY) 

This PP overlay includes the program 6MD which is used to control changes to the CMR directory. If 6MD 
is deleted, the running system may not be changed, but all other functions can be performed. MDI will 
perform the following tasks: 

1. Request field length for directory in CMR. 

2. Set directory change flag. 

3. Get length of directory. 

4. Place CM address into LNT for CM resident libraries. 
5; Copy directory to control point. 

6. Copy directory to CMR. 

7. Check CP activity flags at each control point. 

8. Write current directory file. 

9. Attach FNT to ZZZZZ06 to EDITLIB control point. 
10. Monitor EDITLIB error flag after GO. 

A parameter list will be provided in EDITLIB for MDI. This list will contain MDI request code and all 
necessary information. MDI will return information to EDITLIB in this list. This list is the MDI INPUT/ 
OUTPUT register. 
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TABLE FORMATS 
CMR Directory 

59 



41 



35 



23 



17 



T.LIB 



LWA+1 of LNT 



Library Name Table (LNT) 
(5 Words per Entry) 



LWA+1 of PP 
Program Bodies 



LWA+1 of PPNT 



PP Program Name Table (PPNT) 
(2 Words per Program) 



PP Program Bodies 



CM Resident Libraries 



CMR DIRECTORY NOTES 



ENTRY 
LNT 



FLAG BITS 







- 2 

- 3 
4-16 

- 17 



CM resident library 

ECS resident library 

unused 

EDITEXTEND/SYSTEM library 

unused 

1 = use disk address only 
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PPNT 



EPNT 




1 

2 
3 



0-2 



PNT 



11-0 
12-14 



R 



EDITEXTEND/SYSTEM record 
ECS resident 
CM resident 
control card callable 



000 = relocatable program 

001 = overlay 
010-111 = unused 
control card callable 



EFL command can override FL specification 
xxO program on EDITEXTEND 
xx 1 program not on EDITEXTEND 
OOx disk address 
01X CM address 
lOx ECS address 
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CMR Library Format 
59 47 



35 



17 



Length 
of PNT 



Length 
of PNUT 



Length of 
ERT 



Entry Point Name Table (EPNT) 
(1 Word per Entry Point) 



External Reference Table (ERT) 
(1 Byte per External Reference) 



Program Number Table (PNUT) 
(1 Byte per Entry Point) 



Program Name Table (PNT) 
(2 Words per Program) 



Library Program Bodies 



11 



Length of 
EPNT 



Notes: 



All information that is a part of the system directory and resides in ECS will be on the 
ECS file called ZZZZZ06. 
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Library Name Table Format 



Entry Point 
Name Table 

External 
Reference Table 

Program 
Number Table 

Program 
Name Table 



Word 
Bit 

Bit 1 





CM Library 


59 




luo lidi ai y ■■ 
EDITEXTEND/ 
SYSTEM Library -, 




Modified Library — 
Use Disk Address — 
35 


14 3 


Library Name 






Address of ECS 
Descriptor 


CM FWA of 
Library 


Disk Address of 
Library 


Address of ECS 
Descriptor 


CM FWA of 
Library 


Disk Address of 
Library 


Address of ECS 
Descriptor 


CM FWA of 
Library 


Disk Address of 
Library 


Address of ECS 
Descriptor 


CM FWA of 
Library 


Disk Address of 
Library 



Bit 3,. 

Bit 15 

Bit 16 

Bit 17 



Library is not CM resident. 

1 Library is CM resident. 

Library is not ECS resident. 

1 Library is ECS resident. 

If bits and 1 are both zero, the directory is on disk. 

Library on file ZZZZZ04 

1 Library on file ZZZZZ03 , 
Library is new. 

Library is modified. 

Residency addresses are valid. 

1 Use disk address only. 
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Bits 15, 16, and 17 are set and cleared by EDITLIB only. They are used when EDITLIB is changing a 
directory that contains many libraries. Any routine that is accessing the library that has these bits set must 
use the disk address to obtain any library table and any routine that is part of this library. These bits are 
necessary due to the dynamic allocation of ECS and the nature of the new directory. 



Bits 18-59 



The library name; can contain up to 7 alphanumeric characters of which the first must 
be alphabetic. 



Word 2: 

Address word for the Entry Point Name Table. 

Word 3: 

Address word for the External Reference Table. 

Word 4: 

Address word for the Program Number Table. 

Word 5: 

Address word for the Program Name Table. 



Example: 



Bits 



2 


1 




















1 





1 






Library is disk resident. 
Library is CM resident. 
Library is ECS resident. 



Note: Fields not being used contain zero. 
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Entry Point Name Table Format 
59 



Bits 0-2 

Bit 3 

Bits 4-14 
Bits 18-59 



17 14 



3 



Entry Point Name 



Access 
Level 



Control Card Callable — ' 

000 = Relocatable 

001 = Overlay 



H 



000 The entry point belongs to a relocatable program 

00 1 The entry point belongs to an overlay. 

This entry point cannot be called from a control card. 

1 This entry point can be called from a control card. 

These are the Access Level bits for INTERCOM. 

Entry Point Name value is equal to its position in the table relative to the start of 
the table. The table is sorted alphabetically. 
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PP Program Name Table Format 



EDITEXTEND/ 

Com 
59 41 38 35 23 17 


SYSTEM Record . 


CM Resident 1 

trol Card Callable— i 

4 


PP Program 
Name 





Length in 
CM Words 





Access 
Level 


ECS Address 


CM Address 


Short Disk Address 
if in CM or ECS 








Long Disk Address if not in CM or ECS 



Word 1: 
Bit 

Bit 1 

Bit 2 

Bit 3 

Bits 4-14 
Word 2: 



If the record is on (pfn) ZZZZZ04 

1 If the record is on (pfn) ZZZZZ03. 

Record /routine is not ECS resident. 

1 Record/routine is ECS resident. 

Record/routine is not CM resident. 

1 Record /routine is CM resident. 

This program cannot be called from a control card. 

1 This program can be called from a control card. 
Access Level bits for INTERCOM. 



If the routine is disk resident, there will be a special disk address in bits 0-35 for use by PP resident. The 
CM address is absolute. 

Fields not being used contain zero. 
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External Reference Table Format 



Entry Point 
Number + 1 


Entry Point 
Number + 1 


Entry Point 
Number + 1 


Entry Point 
Number + 1 


Entry Point 
Number + 1 or 
Continuation 



The first entry of this table is associated with the first entry in the Entry Point Name Table. The chain of 
External References is terminated by 12 bits of zero or by the 5 th parcel not having bit 11 set to 1. If bit 1 1 
is set to 1, the value contained in this parcel, less bit 11, is the relative address of the continuation word. 
The address is relative to the FWA of the External Reference Table plus the Entry Point Name Table. All 
external calls made directly by a routine will be shown in this table. 

Program Number Table Format 



Parcel 

Relative 
PNT Address 


Parcel 1 

Relative 
PNT Address 


Parcel 2 


Parcel 3 


Parcel 4 


Parcel 5 


Parcel 6 






Parcel n 



This table holds pointers relative to the Program Name Table for each Entry Point Number. The Entry 
Point Number is the parcel number in this table. There are 5 parcels per word, stored from left to right in 
the sequential bytes of a word. The value in each parcel is the relative address of the programs's entry in 
the Program Name Table. Address is relative to the start of the Program Name Table. 



8-28 



60306500 A 



Program Name Table Format 



59 



Word 1 : 
Bits 0-10 

Bit 11 



35 



00 = Disk Address 

01 = CM Address 
10 = ECS Address 

17 14 



Program Name 



ECS or CM Address 



Length of 
Binary Program 



1 = Program on 
EDITEXTEND 

[— EFL Override Allowed 
10 



FL Required 
Divided by 100B 



Jt< 



Disk Address 



Contain the amount of field length divided by 1000|to execute this program. If not 
specified during an EDITLIB run. it will be set to IP.SfL/1000. 



Bit 12 



Bits 13-14 



Bits 18-59 



INTERCOM field length override bit 

do not override 

1 may be overridden 

1 Program is on (pfn) ZZZZZ03. 
Program is on (pfn) ZZZZZ04. 

00 Disk address 

01 CM address 
10 ECS address 

Program Name in display code. 



n-' 






The CM address is relative to the LWA+ 1 of this table. Fields not being used contain zero. 
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Entry Point and External Reference List Format 
59 



17 





Program Name 


Entry Point 




Word of Zeros 


External Reference 




Word of Zeros 



The Entry Point and External Reference List has an entry for each program that is a part of the library. 
This list will be maintained by EDITLIB. The entry point and external references for each routine will be 
in alphabetical order and will be left justified with zero fill. 

The index to this record, when the library is not part of the running system, will be in the index record for 
the random file. See figure 8-2. When the library becomes part of the running system, the index to the 
Entry Point and External Reference List for the library is destroyed. The Entry Point and External Refer- 
ence List will be placed following the Entry Point Name Table record. By using the index to the Entry 
Point Table it will be possible to access the External Reference List. A CIO Read Skip request will be used 
with the index to the Entry Point Name Table. Then a read with a zero index will be used to obtain the 
Entry Point and External Reference List. 
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Entry Point Name Table 



External Reference Table 




1 
2 
3 
4 
5 
etc. 



ENTRY1 



ENTRY2 



ENTRY3 



ENTRY4 



ENTRY5 



ENTRY6 





1 
►- 2 

3 
*- 4 

5 
etc. 




1 
2 
3 
4 
5 
etc. 



Program Name Table 



PGMA 



PGMB 



PGMC 



PGMD 



PGME 



PGMF 



s 



S 



y 



y' 



10 / 
/ 



etc. 



Program Number Table 

£ 



y 



11 



12 



13 



14 



Figure 8-2. Library Table Interfaces 
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EXAMPLES 



Deadstart Creation 



READY(NEWSYS,NEW) 

TRANSFER( 1 7,SYSTEM) 

TRANSFER(CMR,NEWCMR) 

SKIPR(1, SYSTEM) 

TRANSFER(*,SYSTEM) 

LIBRARY(NUCLEUS,NEW) 

ADD(*,SYSTEM,LIB = NUCLEUS,AL= 1) 

REPLACE(EDITLIB,LGO,AL = 1 ,FL = 40000 ) 

REPLACE(LOADER,LGO,AL = 1 ,FL = 20000) 

FINISH. 

LIBRARY(FORTRAN,NEW) 

ADD(*,NEWFTN,AL = 0,FL = 45000) 

FINISH. 

LISTLIB(*,NEWSYS,NUCLEUS) 

LISTLIB(*,NEWSYS,FORTRAN) 

ADD(*,SYSTEM) 

REPLACE( 1 SP,LGO,AL = 0,CM) 

LISTLIB(*,SYSTEM) 

LISTLIB(*,SYSTEM) 

LISTLIB(*,SYSTEM,NUCLEUS) 

LISTLIB(*,SYSTEM,FORTRAN) 

COMPLETE. 

ENDRUN. 



System EDITLIB 

READY(SYSTEM,OLD) 

ADD(*,NEWPP) 

LIBRARY(SCOPE 1 ,NEW) 

ADD(*,SYSTEM,LIB = NUCLEUS,DSAL= 1,FL = 40000,FLO= 1) 

REPLACE(LOADER,NEW,DS,AL = 1 ,FL = 20000) 

FINISH. 

LISTLIB(*,SYSTEM,NUCLEUS) 

COMPLETE. 

READY(SYSTEM,OLD) 

ADD(1ZZ,LGO,AL = 0) 

LIBRARY(NUCLEUS,OLD) 

FINISH. 

COMPLETE 

ENDRUN. 
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STANDARD SCOPE CHARACTER SETS 



The character set selected when the system is installed should be compatible with the printers. 

With an installation parameter, the installation keypunch format standard can be selected as 026 or 029; the 
installation parameter can also allow a user to override the standard; a user may select a keypunch mode for his input 
deck by punching 26 or 29 in columns 79 and 80 of his JOB card or any 7/8/9 end-of-record card. The mode remains 
set for the remainder of the job or until it is reset by a different mode selection on another 7/8/9 card. 
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SCOPE SYMBOL DEFINITION B 



SCOPE Text (SCPTEXT) contains all system macros, micros, and symbols used by COMPASS CPU and 
PPU programs that comprise the SCOPE 3 Operating System. SCPTEXT is made up of three integral 
common decks; PPSYS, ACTCOM, and CPSYS. 

PPSYS provides the definition of all macros, micros, and SCOPE symbols, and contains the PP 
macros prototypes. 

ACTCOM contains all of the CPU program system action request macro prototypes. 

CPSYS contains the central processor input/output macros prototypes which call the central proces- 
sor library routine CPC (Central Program Control). 

Peripheral processor text (PPTEXT) contains all the SCOPE symbol definitions and PP macro prototype 
required by the COMPASS programs CEA (deadstart PPO save routine) and DSD (system display driver). 
PPTEXT is made up solely of the common deck PPSYS. 

Symbol definitions can have either of the following forms: 

name EQU absolute expression 

name = absolute expression 

where = is the equivalent of the EQU instruction and the absolute expression is either an absolute value 
or an expression in which all symbols have absolute values assigned. 

PPTEXT symbolic names have the format: 



l.mn 



i Identifier; one or two alphabetic characters specifying the category to which the symbol 

belongs. 

mn Mnemonic; one to six alphanumeric characters suggesting the meaning of the symbol. 
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PPTEXT IDENTIFIERS 

Identifiers that appear in PPTEXT symbolic names follow: 
Identifier Description 



C 



Byte number in CM word (0-4). C identifiers are used for flags and parameters of 12 
bits or less. 



CH Pseudo channel assignments 

D Direct cells 

EX M.ICE parameter values 

F Error flag values 

L Lengths 

LE Length of table entries 

M ppu request of monitor 

N Numbers (quantities of things) 

O Stack processor orders 

0V PPU overlays; mnemonic is the overlay name 

P CM location of pointer words 

R PPU resident entry points 

S Number of bits to right-shift a parameter to right-justify it in a PPU word 



First word address of CM tables. The system programmer should use the P. definition 
rather than access the table directly with the T. definition 



W Relative positions in CM tables 

X Executive processor codes 
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PPTEXT SYMBOLS 

The values associated with these symbols are subject to change in the released version of SCOPE 3.4. 



C.AFL (4) 

C.APF (3) 
C.APFL (1) 
C.CHRQ (3) 

C.CHRQ2 (4) 
C.CMLWA (4) 
C.CPAR (3) 
C.CPCKP (4) 
C.CPCON (3) 
C.CPDFMC (0) 

C.CPDPV (4) 

C.CPECFL (4) 

C.CPECRA (3) 

C.CPECSI (3) 

C.CPEF (1) 

C.CPEVNT (4) 

C.CPFL(4) 



Byte 4 of word P.STR in CMR area containing the available field length; used by 
scheduler 

Byte of word P.PFM1 containing the lower 12 bits of FWA of the APF table. 

Byte of word P.PFM 1 containing the maximum number of entries in the APF table. 

Byte in which each bit represents hardware channels 0-13. MTR sets the bit in the byte 
when a request is made for a reserved channel. JANUS and Stack Processor check this 
byte to determine whether of not to drop the channel. 

Byte in which each bit represents hardware channels 20-33. 

Byte of word P.CMFL containing the length of CM in 100 (octal) word blocks. 

Byte of word W.CPAR containing address of last auto recall request. 

Byte of word CPCKP containing a count of the number of check points taken. 

Byte in word W.CKP containing console checkpoint request flag. 

Byte of word W.CPDFMC containing dayfile message count for the job. When count 
is zero, job is aborted. 

Byte of word W.CPDPV in the control point area containing 2-character dependency 
identifier associated with this job. 

Byte in word in control point area containing number/ 1000B of ECS words assigned 
to control point. 

Byte in word W.CPECS containing RA of ECS direct access area in 1000 (octal) word 
blocks. 

Byte of word W.CPJCP containing ECS field length from the job card. Used if job is 
rerun. 

Byte in word in control point area containing error flag. If zero, there is no error at 
this control point; otherwise, C.CPEF may contain a value defined by the F.x symbols. 

Byte of word W.CPSWP in control point area containing the swapper event bit 
S.CPEVNT. 

Byte in word in control point area which contains central memory field length/ 100 
assigned to this control point. 
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C.CPFLAG (0) 

C.CPFLG (0) 
C.CPFLI (4) 

C.CPFP (4) 

C.CPFST (2) 

C.CPJDA (3) 
C.CPJCA (3) 
C.CPJDT (4) 
C.CPJNAM (0-3) 
C.CPJQP (1) 
C.CPLAI (2) 
C.CPLDR2 (2) 
C.CPLDR3 (3) 

C.CPLINK (3) 
C.CPLIB (4) 
C.CPLIBP (4) 

C.CPLW (0) 
C.CPMSLM (1) 

C.CPMNT (4) 
C.CPMSRC (3) 

C.CPNCSP (4) 



Byte within word W.CPFLAG in control point area which contains JANUS and rerun 
flags. 

Byte in word W.CPSCH containing job swapping flags. 

Byte of word W.CPJCP containing CM field length from the job card. Used if job is 
rerun. 

Byte of word W.CPERT containing flags for use by job processing. The JANUS 
INTERCOM and EXPORT/IMPORT bits are in this byte. 

Byte in word W.CPERT in control point area. Contains the pointer to the FST entry of 
the input file assigned to the control point. 

Job descriptor address in control point area. 

Left 6 bits in byte of word W.CPSCH containing index for job control area. 

Bytes in word W.CPJNAM containing absolute address of job descriptor table. 

Bytes in control point area word W.CPJNAM containing job name (7 characters). 

Byte in word W.CPSCH containing job queue priority for scheduler. 

Byte of word W.CPLDR1 containing the loader-already-in flag. 

Byte in word W.CPLDR2 for temporary use by loader. 

The byte in word W.CPLDR1 of the control point area which contains flags to indi- 
cate the value of the map option, whether to use the old or new loader, flags for 
DEBUG, and flags for REDUCE. 

Byte in word W.CPLINK containing 2-way link to other control points. 

Byte in word W.CPLDR4 for temporary use by loader. 

Byte in word W.CPLS containing a flag set to 1 when 1AJ loads an absolute overlay 
from the system library. 

Byte in word W.CPLW containing loader flags. 

Byte of word W.CPMSLM in the control point area containing mass storage limit in 
PRUs. 

Byte of word W.CPSTG containing job 7 and 9-track tape requirements from job card. 

Byte of word W.CPMSLM in the control point area (together with byte 4) containing 
the running PRU count. 

Byte in word W.CPCC of control point area. Contains pointer to next control state- 
ment to be processed. 
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C.CPOUT (4) 
C.CPPQMS (1) 
C.CPPQS (0) 
C.CPPRI (2) 
C.CPPTMS (4) 
C.CPPTS (2) 
C.CPQNT (0) 
C.CPRA (3) 

C.CPRBID (2) 
C.CPREQ (0) 

C.CPRERN (3) 
C.CPRFL (2) 

C.CPRO (4) 
C.CPRPA (1) 

C.CPRPRI (2) 
C.CPRPV (0) 

C.CPSITM (0-1) 
C.CPSLIC (1) 
C.CPSM (2) 

C.CPSR (1) 



Byte in word W.CPERT chich contains flag indicating JANUS control point. 

Byte in W.CPPTM containing PP quantum in milliseconds. 

Byte in W.CPPTM containing PP quantum in seconds. 

Byte in word W.CPPRI in control point area; denotes class quantum of job. 

Byte in W.PPTIME in control point area containing job's PP use time in milliseconds. 

Byte in W.PPTIME in control point area containing job's PP use time in seconds. 

Byte in word W.CPSWP containing scheduled quantum (accrued CP/PP time). 

Byte in word W.CPSTAT in control point area which contains reference address 
(RA)/ 100 of control point. 

Remote batch job ID field used by INTERCOM; in word W.CPIRB. 

Byte of word W.CPOAE used as a flag to DSD to call REQ when the operator assigns 
equipment. 

Byte in word W.CPERT containing job rerun priority value. 

Byte in word W.CPSCH containing size of FL reserved by scheduler for the control 
point. 

Byte in word W.CPRO temporarily not in use. 

Byte of word W.CPCC in the control point area which, together with byte 
C.CPRPA + 1, contains the address of the post-recovery (reprieve) function, relative to 
RA. 

Byte in word W.CPOAE in control point area which contains rescheduling priority. 

Byte of word W.CPCC in the control point area containing reprieve function check- 
sum value. 

Bytes in W.CPTIME containing swap-in time. 

Byte in W.CPSLIC containing total CPU time slice allotted. 

Byte in word W.CPSM in control point area which contains storage move flag. MTR 
sets this field non-zero when storagd is to be moved. All PPs at this control point 
should pause if C.CPSM is non-zero. 

Byte of word W.CPSR containing the entry count of the number of stack requests 
which cause CM access for this control point. 
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C.CPNFL (3) 
C.CPNUM (1) 

C.CPOAE (4) 
C.CPORG (4) 
C.CPSSW (4) 
C.CPSTAT (0) 

C.CPTIML (0) 

C.CPTLI (1) 

C.CPTMT (0) 
C.CPTNT (1) 
C.CPUAMS (4) 
C.CPUAS (2) 
C.CPUBMS (4) 
C.CPUBS (2) 
C.CPUQMS (1) 
C.CPUQS (0) 
C.CPUTA (2) 
C.CST (2) 
C.CSTCB (2) 
C.CSTCN (1) 
C.CSTL (3) 
C.DATACT (2) 
C.DATDST (0) 



Byte of word W.CPCC containing job nominal field length in 100 (octal) word blocks. 

Byte in PP input register word which contains control point number originating 
request. 

Byte of word W.CPOAE containing EST ordinal of equipment assigned by operator. 

Byte of word W.CPSWP containing job origin for scheduler use. 

Byte in word W.CPSSW contain setting of simulated sense switches. 

Byte in a word W.CPSTAT in control point area which MTR uses to note status of 
control point. 

Byte in word W.CPTIML in control point area which contains job time limit in 15 
bits. 

First byte of a 15-bit field in word W.CPTIML containing the time limit from the job 
card to be used if job is rerun. 

Byte of word W.CPSTG containing current number of 7-track tapes assigned. 

Byte of word W.CPSTG containing current count of 9-track tapes assigned. 

Byte in word W.CPTIME contains CPU-A use time in milliseconds. 

Byte in word W.CPTIME contains CPU-A use time in seconds. 

Byte in word W.CPTIMEB contains CPU-B use time in milliseconds. 

Byte in word W.CPTIMEB contains CPU-B use time in seconds. 

Byte in word W.CPTIME contains CP quantum time in milliseconds. 

Byte in word W.CPTIME contains CP quantum time in seconds. 

Byte in word W.CPSWP contains scheduler user table address. 

Byte in word P.CST in CMR which contains FWA of the channel status table. 

CST/MMTC conversion table address. 

CST channel number. 

Byte in word P.CSTL in CMR which contains LWA+ 1 of the channel status table. 

Byte of the device activity table entry referring to the current activity of the device. 

Byte of the device activity table entry giving the device status table entry. 



B-6 



60306500 A 



C.DATEQP (1) 
C.DIRFWA (0) 
C.DIRPRU (4) 
C.DIRRBA (2) 

C.DIRRBN (3) 

C.DIRUNT (1) 
C.DPT (4) 
C.DSFLAG (4) 
C.ECFLG (0) 
C.ECSBL (2) 
C.ECSPL (0) 
C.ESTAT (0) 
C.ESTCH1 (1) 
C.ESTCH2 (2) 
C.ESTDST (4) 
C.ESTMNE (3) 
C.ESTSD (2) 
C.ESTDL(l) 
C.FABT (0) 
C.FADEV (3) 

C.FALLOC (4) 

C.FAPF (4) 
C.FBKLK (1) 
C.FCB (3) 



Byte of the device activity table entry giving the equipment type. 

Leftmost of two bytes in P.LIB which contains first word address of library directory. 

Byte in second word of a directory entry which contains number of first PRU assigned 
to record. 

Byte in second word of a directory entry containing linkage to RBT word pair defining 
record in which the record starts. 

Byte in second word of a directory entry containing original RBT word pair and byte 
defining block in which record starts. 

Byte in second word of directory entry containing physical unit number (DST ordinal). 

Byte contains block number address of T.DPT. 

Deadstart parameter byte in P.LIB. 

Flag byte in ECS file descriptor. 

Left byte of ECS buffer length field in T.EPBL in CMR pointer area. 

Left byte of ECS page length field in T.EPBL. 

Status/assignment byte in EST. 

Equipment channel assignment field in EST. 

Equipment channel assignment field in EST. 

DST ordinal field in EST entry. 

Hardware mnemonic field in EST entry. 

Special disposition field in 3000 unit record EST entry. 

Device label RB field in allocatable device EST entry. 

Byte of FNT word 3 containing the abort flag. 

Byte of FNT word 2 for an allocatable device file to which no RBT has been assigned. 
Contains the EST ordinal of the device to which it has been assigned. 

Byte in FNT word 2 containing allocation style for a file not yet assigned to mass 
storage. 

Byte of FNT word W.FTYPE containing the APF pointer for a permanent file. 

Backward link in FNT supplement entries. 

Byte in word in FNT mass storage file entries which contains the current RB byte. 
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C.FCPNUM (3) 
C.FCPRU (3-4) 
C.FCPU (0) 
C.FCREC (1) 
C.FCS (3) 
C.FDC (2) 
C.FDEVTP (0) 
C.FDPCT (0) 
C.FDPV (1) 

C.FECFL (2) 
C.FECS (3) 
C.FEQP (0) 
C.FFETAD (0) 
C.FFL (4) 
C.FFRBA (1) 

C.FINFLG (3) 
C.FINTID (3) 
C.FIOTID (1) 
C.FLBL (3) 



C.FLINK (3) 
C.FLNKAD (4) 



Byte in word 1 of a file name table entry containing file's control point assignment. 

Two-byte field in tape file FNT entry containing current PRU count. 

CPU-A/B flag field in input file entry of FNT. 

Record count in card file entry of FNT. 

Leftmost of two bytes in word 3 of FNT entry containing code and status field. 

Byte in word 3 of FNT entry containing file disposition code. 

Device type/equipment code field in FNT entries. 

Byte of word 3 of the input file name table entry containing the job dependency count. 

Byte of word 3 of the input file name table entry containing the 2 character job 
dependency identifier. 

Byte of FNT word 2 containing the ECS field length for a job in the input queue. 

ECS flag bits in FNT entry (local file). 

Byte in word 2 of FNT entry containing file equipment code. 

FET address in mass storage entry in FNT. 

Byte of FNT word 2 containing the CM field length for a job in the input queue. 

Byte in word 2 of FNT entry containing address of first RBT word pair for a file on 
allocatable device. 

Input flag field in FNT entry for input file. 

INTERCOM user ID field in FNT entry supplement (input file). 

INTERCOM user ID field in output file FNT entry for output queue. 

Byte in word 2 of FNT entry. For magnetic tape, byte C.FLBL contains upper 12 bits 
of current physical record unit (PRU) count; lower 12 bits of PRU count are in byte 
C.FLBL + 1. For punched cards, byte C.FLBL is 12-bit byte containing upper 5 bits of 
card count within a record being punched; lower 12 bits of card count are in bvte 
C.FLBL +1. 3 

Byte in FNT first word containing link bit. 

Byte in first word of FNT entry containing link pointer. 
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C.FLOCID (3) 
C.FLOCK (3) 
C.FLPRU (4) 

C.FLRBEB (3) 

C.FLRBWP (2) 

C.FMUJ (3) 
C.FMUJC (3) 
C.FNAME (0) 
C.FNT (0) 
C.FPDEV (2) 

C.FPFREW (3) 
C.FPPFN (3) 
C.FPRI (4) 
C.FRECCT (0) 
C.FRRN (0) 
C.FSC (3) 
C.FSDC (1) 
C.FSDT (0) 
C.FSPDIS (3) 
C.FTAPE (0) 
C.FTL (0) 



Byte in FNT entry containing INTERCOM user ID (local file). 

Byte in word 1 of FNT entry containing the lock bit. 

Byte in word 2 of FNT entry containing current physical record unit (PRU) position 
of a file on an allocatable device. 

Byte in word 2 of FNT entry containing RBT entry and byte at which a file on 
allocatable device is currently positioned. 

Byte in word 2 of FNT entry containing address of current RBT word pair for file on 
allocatable device. 

Multi-user job flag bit field in INTERCOM user FNT entry. 

Multi-user job code in INTERCOM user FNT entry supplement. 

Leftmost of four bytes in word 1 of FNT entry containing seven-character file name. 

Input file tape requirements field in FNT. 

Byte in FNT word 2 of tape FNT entry containing primary device number (EST 
ordinal). 

Permanent file rewrite bit in local file flag field of FNT. 

Private pack family no. or EST ordinal for local mass storage FNT entry. 

Byte in FNT word 1 containing priority of input or output file. 

Card file record count field in word 2 of FNT entry. 

Byte of FNT word 2 containing the rerun flag for a job in the input queue. 

Byte in FNT word 3 containing file security code, indicates whether or not file is open. 

Byte in FNT word 3 used when a file has a special disposition. 

Special dispose ID in FNT supplement for output file during printing. 

Input file tape requirements in FNT entry word 2. 

First byte of a two-byte field in FNT word 3 containing the time limit for a job in the 
input queue. 



C.FTPORD ( 1 ) T.TAPES ordinal field in word 2 of tape file FNT entry. 
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C.FVSN (1) 
C.F2PC (3) 
C.HEC (4) 
C.IBSTAT (4) 
C.IBUFF (2) 
C.IFBUFR (1) 
C.IFL (0) 
C.ILSFL (0) 
C.ILTABL (4) 
C.INBUF (0) 
C.INT (0) 
C.INTDSD (3) 
C.INUSER (2) 
C.ITABL (1) 
C.IUAUT (2) 
C.IUCCA (0) 
C.IUEQC (0) 
C.IUEST (0) 
C.IUFILE (4) 
C.IUFL (2) 
C.IUFRB (1) 
C.IUJDA (0) 
C.IUMJS (0) 
C.IUPF (2) 



Volume serial no. in FNT supplement of unassigned tape file. 

Punch file 2PC flag in word 2 of FNT entry. 

Byte of word P.HEC containing the hardware error count. 

Byte in CMR word P.INT. 

Byte containing fwa of INTERCOM low speed buffers. 

Byte in word P.INT in CMR pointer area. 

LWA+ 1/100 of INTERCOM buffer area. 

Length of INTERCOM table. 

Address of next linked INTERCOM buffer. 

INTERCOM up flag. 

INTERCOM/DSD communications byte. 

Number of INTERCOM users. 

Byte in word P.INT in CMR pointer area. 

INTERCOM auxiliary user table pointer. 

INTERCOM user control card buffer pointer. 

INTERCOM equipment code. 

INTERCOM multiplexor EST pointer. 

INTERCOM user flags field. 

INTERCOM user job fl/100 (includes positive fl). 

INTERCOM user-address of first record block of job. 

INTERCOM job descriptor entry address. 

INTERCOM user MUJ status. 

INTERCOM partially up flag. 
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C.IUPFL (3) 
C.IUPORT (0) 
C.IUSID (2) 
C.JCA (2) 
C.JCAR (2) 
C.JCBQ (4) 
C.JCCLK (2) 
C.JCCNB (0) 
C.JCCTB (1) 
C.JCEMC (2) 
C.JCMAX (1) 
C.JCMIN (0) 
C.JCMTB (1) 
C.JCMXB (0) 
C.JCNJI (4) 
C.JCNTJ (3) 
C.JCPRF (2) 
C.JCQP(3) 
C.JDBP (3) 
C.JDCPN (0) 
C.JDCPT (1) 
C.JDEQC (0) 
C.JDFL (3) 
C.JDFLG (2) 



FWA/ 100 of INTERCOM job positive fl. 

INTERCOM port number. 

INTERCOM user job ID. 

Byte in CMR area word P.SCH containing pointer to job control area/ 10. 

Job aging rate entry in job control area. 

Job base quantum value. 

Flag in job control area set by 1 IB when it fails to bring up a job. 

Current count of batch job entries in job descriptor table. 

Current count of batch jobs with non-allocatable devices in JDT. 

Count of empty FNT entries kept in job control area. 

Maximum queue priority value. 

Minimum queue priority value. 

Maximum number of batch jobs with non-allocatable devices. 

Maximum number of batch jobs. 

Number of ready batch jobs in input queue. 

Number of ready tape jobs in input queue. 

Priority flag byte in job control area. 

Quantum priority value in control point area. 

Job base priority in job descriptor entry. 

Control point number assigned to job in this JDT entry. 

Accumulated CPU time by job in this JDT entry. 

Equipment code byte in JDT entry. 

Job fl including positive field length. 

Job flag word in JDT entry. 
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C.JDFRB (1) 
CJDID (0) 
C.JDIFLG (2) 
C.JDIUTA (2) 
C.JDJST (0) 
C.JDLNK (3) 
C.JDLPFL (4) 
C.JDOPF (3) 
C.JDORD (1) 
C.JDORG (4) 
C.JDPFL (4) 
C.JDPFM (1) 
C.JDRU (4) 
C.JDT (4) 
C.JDTIN (1) 
C.JDTL (2) 
C.JQP (1) 
C.LEJDT (0) 
C.LJDT (3) 
C.LRD (3) 
C.MAILF (0) 
C.MAILL (1) 
C.MVFG (1) 
C.NCP (4) 



First RBT word pair for job. 

User ID for remote batch job entries in JDT. 

INTERCOM user flag field in JDT entry. 

Address of new user table for INTERCOM user. 

Job status and job class byte in JDT entry. 

Address of next job descriptor entry in queue. 

Length/ 1 00 of positive fl. 

Operator flag byte in JDT entry. 

Job descriptor ordinal. 

Job origin of job having this JDT entry. 

Positive fl address. 

Permanent file permission bits. 

Resource usage (PP/CP) by job. 

Pointer to JDT in word P.SCH in CMR pointer area. 

Time job entered job descriptor table (time in). 

Time limit for job. 

Job queue priority byte in word P.STR in CMR area. 

Byte in P.SCH which contains length of each JDT entry. 

Byte in P.SCH which contains the length of the Job Description Table. 

Bytes in CMR containing logical record definition table address and length. 

Byte in CMR word P.MAIL containing pointer to scheduler mailbox buffer. 

Byte in CMR word P.MAIL containing size of scheduler mailbox buffer. 

Storage move flag for real time programs. 

Byte of word P.NCP containing the number of control points. 
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C.NFL (0) 
C.NOVA (1) 

C.NOVAL (2) 

C.NPP (3) 
C.PCFLAG (4) 
C.PCOM (4) 
C.PDFLAG (4) 
C.PFACT (2) 
C.PFCNT (2) 
C.PFCNT2 (1) 
C.PFCY (3) 
C.PFD1 (0) 
C.PFD2 (1) 
C.PFD3 (2) 
C.PFD4 (3) 
C.PFFNT (4) 
C.PFLAG (4) 
C.PFMCH (4) 
C.PFQ (4) 
C.PFRBT (0) 
C.PJTFWA (3) 
C.PJTLWA (4) 
C.PPFAF (2) 



Needed field length (Scheduler) in word P.STR in CMR area. 

Byte of word P.NOVA containing the FWA/ 10 of the NOVA (Interactive Graphics) 
table. 

Byte of word P.NOVA containing the length of the NOVA (Interactive Graphics) 
table. 

Byte of word P.NPP in CMR containing the number of PPs in the configuration. 

Flag byte in RBTC header word. 

FWA of PP communication areas. 

Flag byte in PFD header word. 

Permanent file activity count. 

APF entry byte count # 1 . 

APF entry byte count #2. 

File cycle number attached (APF entry). 

APF entry byte 

APF entry byte Permanent file 

APF entry byte directory pointer. 

APF entry byte 

FWA of permanent file FNTs. 

Attached permanent file usage flag byte. 

Permanent file interlock (toggle) byte in word P.PFM 1 . 

APF entry byte — PFQ address. 

First RBT address of attached permanent file cycle (APF). 

FWA of peripheral job delay stack parameter list. 

LWA of peripheral job delay stack in P.PJT of CMR pointer area. 

The byte in the PP status word which contains the field access flag. 
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C.PPFWA (1000) Location in PP memory at which PP resident is to begin execution of a primary 
overlay. Used both as the second parameter in IDENT card and in address field of 
ORG on all primary PP overlays. 



C.PPSWA (2000) 

C.PPTWA (3000) 

C.PP4WA (4000) 
C.PP5WA (5000) 
C.PP6WA (6000) 
C.PP7WA (7000) 
C.RBRA (3) 
C.RBRAD (0) 
C.RBRAL (3) 

C.RBREST (2) 
C.RBRLAV (3) 

C.RBRTPA (0) 
C.RBRUNT (1) 
C.RBTAL (2) 
C.RBTBIT (4) 
C.RBTCL (3) 
C.RBTC1 (0) 
C.RBTC2 (1) 
C.RBTC3 (2) 



Location in PP memory for beginning execution of a secondary overlay. Used same as 
C.PPFWA. 

Location in PP memory at which to begin execution of a tertiary overlay. Used same 
as C.PPFWA. 

Location in PP memory at which to begin execution of a fourth level overlay. 

Location in PP memory at which to begin execution of a fifth level overlay. 

Location in PP memory for beginning execution of a sixth level overlay. 

Location in PP memory at which to begin execution of a seventh level overlay. 

Byte in RBR header containing permissable allocation. 

Byte in word P.RBR containing FWA of the RBR area. 

Byte of word W.CBRUNT of the RBR table that designates the allocation stype. If the 
high order bit of this byte is set then files without specified allocation style may go on 
this device. 

Byte of word W.RBRLAV of the RBR table containing the EST ordinal. 

Byte in second word of each RBR header containing count of unassigned record blocks 
defined in the RBR. 

Byte in first word of each RBR header defining device type referenced. 

Byte in word one of RBR header containing DST ordinal. 

Byte in first word of RBT word pair containing allocation type of file. 

Byte of first word of the RBR word-pair containing flags. 

Byte in word P.PFM2 containing the number of PRU/8 in RBTC. 

See C.RBTC3. 

See C.RBTC3. 

These bytes in P.PFM3 contain the current end-of-information pointer for the RBTC 
used by the permanent file system. 
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C.RBTFB (1) 

C.RBTFL (2) 
C.RBTPRU (3) 

C.RBTRBR (1) 
C.RBTWPL (0) 
C.RCL (3) 
C.RFL (2) 
C.RMS (2) 

C.RMSL (3) 
C.RPTCP (2) 
C.RPTEST (0) 
C.RPTFST (1) 
C.RPTPKN (3) 
C.RPTVID (0) 
C.RQSCS (0) 
C.RQSFS (2) 
C.RSTA (2) 
C.RSTRA (1) 

C.RSTU (4) 
C.RSTWP (3) 
C.RWPPCC (3) 



Byte in first word of RBT word pair containing byte number of first record block 
address. 



Byte in first RBT word assigned to each file which defines last+ 1 PRU assigned to 
that file. 

Byte in first word of RBT word pair containing RBR ordinal for the file. 

Byte in each RBT word pair containing linkage to next RBT word pair for that file. 

Reserved field length (Scheduler). 

Byte of word P.RMS in CMR containing the starting address (divided by 8) of the 
RMS table. 

Byte of word P.RMS in CMR containing the length of the RMS table. 

Control point number byte in removable pack table (RPT) entry. 

EST ordinal byte in RPT entry. 

FNT address byte in RPT entry. 

Removable pack device code (AM or AP) in display code. 

Visual identifier of current pack. 

Byte in stack pointer word (P.RQS) containing a count of the stack entry word pairs. 

Byte in stack pointer word (P.RQS) containing address of first stack entry. 

Byte in M.EREQS Monitor function containing PP available flag. 

Byte in M.EREQS Monitor function containing request accepted field which is used 
for Monitor-PP Resident communication. 

Byte in M.EREQS Monitor function containing unit number (DST ordinal). 

Byte in M.EREQS Monitor function containing request stack word pair address. 

Byte in READP/WRITEP control word into which stack processor for control phase 1 
places channel number to be used in data transmission. 
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C.RWPPCF (0) 



C.RWPPLW (2) 

C.RWPPST (3) 

C.RWPPWC (4) 

C.RWPPWT (1) 

C.SCHPT (3) 
C.SDL (0) 
C.SDTL (0) 
C.SEQ (2) 
C.SEQL (3) 
C.SRS (1) 
C.STCPU (4) 
C.STFB (3) 
C.STG (4) 
C.STGFLG (2) 
C.STGMT (0) 
C.STGNT (1) 
C.STMF (3) 
C.STO (3) 



Byte containing phase control flag in control word for READP/WRITEP. 
Phases: 

= Request in stack 

1 = Set channel 

2 = Channel set, await transmission 

3 = Transmission in progress 

4 = Order completed. 

Byte in READP/WRITEP control word containing LWA + 1 of data transmitted. It is 
updated by PP Resident during order each time it completes phase 3. 

In READP/WRITEP control word, operation status available in phase 4 is contained 
in this byte. 

In READP/WRITEP control word, word count for transmission during phase 3 is 
contained in this byte. 

In READP/WRITEP control word, total number of words transmitted during all 
phase 3s is cumulated by PP Resident in this byte. 

FWA/ 10 of CMR statistics table. 

Byte in word P.PFM2 containing the number of entries per subdirectory. 

Byte in word P.PFM1 containing the number of permanent file subdirectories. 

Byte in word P.SEQ containing the FWA/ 1 00 of the sequencer table. 

Byte in word P.SEQ containing the length of the sequencer table. 

Byte in word P.SCH containing FWA/ 10 of scheduler exchange package. 

Byte in word 1 of stack request containing control point and unit number. 

Flag byte in word 2 of a PP request stack. 

Input staging pointer to tape staging table (T.STG). 

Tape staging scheduled by operator (on/off option). 

7-track tape byte for T.STG. 

9-track tape byte for T.STG. 

Scheduler. 

Specific order in word 1 of a stack request: high order 6 bits are a record level number 
when relevant (order = O.SKF). 
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C.STPFW (2) 

C.STPLW (4) 

C.STPMS (1) 

C.STPPRU (2) 

C.STPRBA (0) 

C.STPRBN (1) 

C.STPWC (0) 
C.SWPECS (2) 
C.TFLGS (0) 
C.VRNFIN (1) 
C.VRNFNT (4) 
C.VRNFUL (4) 
C.VRNFWA (0) 
C.VRNINT (3) 
C.VRNNXT (3) 
CH.CPA (34) 
CH.DMP (37) 
CH.EST (40) 
CH.FNT (15) 



Next address in PP memory for data in word 2 of READP/WRITEP stack request. 
Used by PP Resident to compute byte count and as FWA for data transmission in a 
call to R.READP or WRITEP. 

Last address in PP memory for data in word 2 of a READP/WRITEP stack request. 
Used by PP Resident to compute byte count in call to R.READP or R.WRITEP. 

Location of message buffer of PP in word 2 of a READP/WRITEP stack request. First 
3 words are used for communication with stack processor. 

PRU number at which to begin data transmission in word 1 of a stack request with 
flag set for no FNT. 

RBT address of word pair containing record block at which to begin data transmission 
in word 1 of stack request with flag set for no FNT. 

RBT ordinal of record block at which to begin data transmission in word 1 of stack 
request with flag set for no FNT. 

Count of bytes to be transmitted in word 1 of READP/WRITEP stack request. 

ECS swap flags. 

Tapes table flag bits. 

RA within VRN (VSN) buffer. 

FNT address within VRN buffer. 

VRN buffer full flag. 

FWA/ 10 of VRN buffer pointer in CMR word P.VRNBUF. 

VRN buffer interlock byte in CMR word P.VRNBUF. 

Next link number within VRN buffer. 

Pseudo-channel for control point area interlock. 

Pseudo-channel used by DMP. 

Equipment status table pseudo-channel (see CH.TAPE). 

File Name Table pseudo-channel; possession of this channel interlocks word one of 
FNT. 
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CH.FST (14) 

CH.ICOM (41) 
CH.IEMBF (42) 
CH.IHSMT (46) 
CH.IHUSR (45) 
CH.INS (36) 
CH.IUSER (43) 
CH.LIB (16) 
CH.PFM (35) 
CH.RBT (17) 
CH.SCH (44) 
CH.TAPE (40) 
D.BA (40) 

D.CPAD (76) 

D.DTS (37) 

D.EST (32) 
D.FA (57) 
D.FIRST (60) 

D.FL (56) 

D.FNT (20) 



File Status Table pseudo-channel; possession of this channel provides an interlock of 
words two and three of the FNT (alternately called FST). 

INTERCOM /SCOPE interlock channel. 

INTERCOM low speed empty chain channel. 

INTERCOM high speed empty chain channel. 

INTERCOM high speed user tables channel. 

Pseudo-channel reserved for installation use. 

INTERCOM user pseudo-channel. 

Library directory pseudo-channel; only used by GP250 software package (NOVA). 

Pseudo-channel used by permanent file manager. 

Record Block Table pseudo-channel. 

Scheduler pseudo-channel. 

Tapes table pseudo-channel. 

D.BA through D.BA + 4 contain first word of file environment table (FET) located by 
relative address in low order 1 8 bits of input register. 

Typically contains address of control point area currently in use by PP. A primary 
overlay usually stores the address as part of its initialization. 

High order 6 bits of D.DTS contain device type found in high order portion of byte 
of second word of FNT. Low order 6 bits of D.DTS contain allocation type found in 
low order portion of byte of second word of FET. 

D.EST through D.EST + 4 contain EST entry in process. 

Contains address of second word of FNT entry in process. 

D.FIRST and D.FIRST + 1 contain 18-bit CM address specifying beginning of a circu- 
lar buffer (contents of first pointer (word 2) from a FET). 

Central memory field length/ 100 of control point to which PP is currently attached. 
Primary overlay usually stores field length as part of initialization. 

D.FNT through D.FNT + 9 contain word 2 and 3 of FNT entry for file in process. 
Word 2 and 3 are alternately referred to as the FST entry. 
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D.HN (71) 

D.IN (62) 
D.JECS (45) 
D.JFL (37) 
D.JPAR (32) 
D.JPR (46) 
D.LIMIT (66) 

D.OUT (64) 
D.PPIR (74) 

D.PPIRB (50) 

D.PPMES1 (75) 

D.PPONE (70) 

D.PPSTAT (77) 
D.RA (55) 

D.TH (72) 

D.TR (73) 

EX.CMSM (0) 
EX.ECOVL (2) 
EX.ECSM (1) 
EX.FLHB (15) 



Constant value of 100 (octal). Generally, D.HN is preset by a primary overlay for use 
by a secondary overlay. 

D.IN and D.IN+ 1 contain IN pointer (word 3) from FET. 

Used by 2TJ to return ECS field length requirement to calling program. 

Used by 2TJ to return CM field length requirement to calling program. 

PP word containing the first word address of the job parameter table. 

Used by 2TJ to return computed priority to calling program. 

D.LIMIT and D. LIMIT +1 contain 18-bit address specifying LWA+1 of circular 
buffer (contents of LIMIT pointer (word 5) from FET). 

D.OUT and D.OUT + 1 contain OUT pointer (word 4) from FET. 

Contains CM address of PP input register. Initialized at deadstart time and must never 
be altered. 

D.PPIRB through D.PPIRB + 4 hold the contents of PP input register. Primary overlay 
usually stores input register contents as part of initialization. 

Contains CM address of first word of PP message buffer. Initialized at deadstart time 
and must never be altered. 

Contains constant 1. Generally, D.PPONE is preset by a primary overlay for use by a 
secondary overlay. 

PP word containing the CM address of the PP status word for this PP. 

Contains central memory reference address/ 100 of control point to which PP is at- 
tached. Primary overlay usually stores address as part of initialization. 

Contains constant 1000 (octal). Generally, D.TH is preset by a primary overlay for use 
by a secondary overlay. 

Contains constant 3. Generally, D.TR is preset by a primary overlay for use by a 
secondary overlay. 

CM storage move. 

Load ECS resident routine. 

ECS storage move. 

Flush ECS buffer. 
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EX.MVIN (13) 
EX.MVOUT (14) 
EX.RELEB (10) 
EX.RELSB (12) 
EX.REQEB (7) 
EX.REQSB (11) 
EX.SCH (5) 
EX.SCH1 (6) 
EX.SPM (3) 
F.ERAR (2) 

F.ERCC (11) 
F.ERCP (4) 

F.ERECP (12) 

F.EREX (11) 

F.ERHANG (16) 
F.ERJC (13) 
F.ERK (7) 

F.ERMSL (17) 
F.EROD (6) 
F.ERPA (14) 
F.ERPARF (61) 



Move into ECS. 

Move out of ECS. 

Release ECS file buffer. 

Release system buffer. 

Request ECS file buffer. 

Request system buffer. 

Standard scheduler call. 

Scheduler storage request. 

SPM call. 

Value of error flag set for CP arithmetic error abort. Sensed by MTR; error message is 
written by 1EJ. 

Error flag value set for a control card error. 

Value of error flag set for CP abort. F.ERCP used if CP program aborts execution; 
program must write a message to dayfile. 

Value of error flag set when MTR detects permanent parity in ECS during ECS stor- 
age move. 1EJ writes a message to dayfile. 

Value of error flag set by 1AJ when it detects a control card error, or by MTR when it 
gets an ABT request with the exit(s) bit (bit 36) set. 

Error flag for job hung in automatic recall. 

Error flag for a job card error. 

Value of error flag in control point area set when operator types "n.KILL". There will 
be no output from this job. 

Value of the error flag when the mass storage limit has been exceeded. 

Value of error flag set for operator drop type-in. 1EJ writes a message to dayfile. 

Error flag for a job which has been pre-aborted, i.e., before it comes to control point. 

Parity error occurred when swapping-in a job. 
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F.ERPCE (5) 

F.ERPP (3) 

F.ERRCL (15) 
F.ERRN (10) 

F.ERTL (1) 

F.ESABS (0) 
F.ESCPA (2000) 
F.ESOFF (0) 
F.ESON (4000) 
F.ESREL (1000) 
F.JDACT (2) 
F.JDBAT (1) 
F.JDBNA (2) 
F.JDDROP (2) 
F.JDEXP (5) 
F.JDINP (0) 
F.JDINT (3) 
F.JDKILL (1) 
F.JDLMB (0) 
F.JDMUJ (4) 
F.JDRRNP (4) 
F.JDRRUN (3) 



Value of error flag set for PP call error abort. Sensed by MTR; error message is 
written by 1EJ. Used when central program requests PP program with name that does 
not begin with a letter. 

Value of error flag set for PP abort. PP requesting abort is responsible for writing 
message. 

Error flag for a bad PP call with the auto-recall bit set. 

Value of error flag in control point area set when the operator types "n.RERUN". This 
job will be put back into the input queue. 

Value of error flag set for CP time limit abort. Sensed by MTR; error message is 
written by 1EJ. 

Event stack word address is absolute. 

Event stack word address is relative to control point address. 

Event stack job assigned when bit is 0. 

Event stack job assigned when bit is 1 . 

Event stack word address is relative to RA. 

Job active at control point (status flag in C.JDJST of JDT entry). 

Job class is batch. 

Job class is batch with non-allocatable device. 

Job dropped — error code. 

Job class is express. 

Job in input queue. 

Job class is INTERCOM. 

Job killed — error code. 

Job status — in limbo. 

Multi-user job class. 

Rerun job with priority — specified code. 

Job rerun — error code. 
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F.JDWCC (3) 
F.JDWCM (10) 
F.JDWDA (30) 
F.JDWIA (50) 
F.JDWOA (40) 
F.JDWPF (20) 
F.JDWSI (1) 
F.MVFG (2) 
LE.APF (2) 
LE.DFB (100) 
LE.DPT (12) 
LE.FNT (3) 
LE.MAIL (6) 
LE.TAPES (10) 
L.CPNUM (17) 
L.IBUFF (20) 
L.MTRRS (4) 
L.PPHDR (5) 

L.SCHRS (4) 
N.STG (2) 
O.BPRU (16) 

O.RCHN (17) 



Job waiting for control point cleanup — status. 

Job waiting for CM — status. 

Job waiting for device assignment — status. 

Job waiting for INTERCOM action — status. 

Job waiting for operator action — status. 

Job waiting for permanent file action — status. 

Job waiting for swap in — status. 

Storage move flag for real time programs. 

Length of APF entry. 

Length of dayfile buffer. 

Length of device pool table. 

Length of FNT entry. 

Length of mailbox entry. 

Length of tapes table entry. 

Mask of ones equal to the length in bits of highest numbered control point. 

Length of INTERCOM low speed buffer. 

Length of CPMTR to MTR request stack. 

Number of PP words comprising header information appended by assembler. Loading 
of all PP overlays begins at C.PPxWA minus L.PPHDR. 

Length of scheduler request stack. 



Backspace n PRUs. Number of PRUs to be backspaced is given in third byte of second 
word of the order. O.BPRU requests repositioning defined by physical rather than 
logical units. No data is transmitted. 

Release chain. All record blocks assigned to a file and the RBT word pairs containing 
them are released. FNT is reset to an empty condition if its address is supplied in the 
order. Requests 16 and 17 required no communication with the device and, therefore, 
are given highest priority in the search for the next order to be executed. All other 
requests are assigned priority based on repositioning requirements. 
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O.RCMPR (2) 

O.RCTU (20) 
O.RCTNU (20) 
O.RDNS (3) 
O.RDP (10) 

O.RDPNP (11) 

O.RDSK (1) 

O.READ (0) 

O.RMR (6) 

O.SKB (13) 
O.SKF (12) 

O.WCTU (24) 
O.WCTNU (24) 

O.WRP (14) 

O.WRPR (15) 



O.WRT (4) 
O.WRTR (5) 



Read into central memory after dropping first three CM words of first PRU. Used for 
loading program from system library eliminating the three word header added to 
system programs by EDITLIB. 

Read continuous order code. 

Read continuous order code. 

Value of the stack processor order code for non-stop read. 

Read into requesting PP's memory until a short PRU is encountered or until input 
area is full. 

Read into requesting PP after dropping first three CM words of first PRU. Used for 
all PP system program calls. 

Read into central memory until a short PRU is encountered or until buffer is full. Set 
FNT to reference first PRU following first end-of-record of level X or greater. Level is 
given in high-order 6 bits of the order byte. 

Read into central memory until a short PRU is encountered or buffer is full 
(IN = OUT). 

Read multiple records order code. 



Skip backward /forward n records of level X or greater. Level is specified in high 6 bits 
of the order byte; number of records to be skipped is given in third byte of second 
word of the order. No data is transmitted. 



Write continuous order code. 

Write from requesting PP, full PRUs only. 

Write from requesting PP, ending with a short PRU of level specified in high order 6 
bits of order byte. 

If EOF flag bit is set in this order, a zero length PRU of level 1 7 is written following 
short PRU terminating record. 

Write full PRUs from central memory. 

Write from central memory, ending with a short PRU of level specified in high order 
6 bits of the order byte. If EOF flag bit is found in this order, a zero length PRU of 
level 1 7 is written following short PRU terminating record. 
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OV.ACE 

OV.ALJ 

OV.APR 

OV.CEM 

OV.CIO 

OV.CKP 

OV.CLO 

OV.CON 

OV.CTS 

OV.DIS 

OV.DMP 

OV.DPF 

OV.EC1 

OV.EFL 

OV.EPF 

OV.ETL 

OV.FNT 

OV.GEJ 

OV.IAP 

OV.LDR 

OV.LOD 

OV.LPF 

OV.MDI 

OV.MEM 

OV.MES 

OV.MSG 

OV.OPE 

OV.PFA 

OV.PFC 

OV.PFE 

OV.PFG 

OV.PFM 

OV.PFP 

OV.PFR 

OV.PFS 

OV.PRM 

OV.REQ 

OV.RFL 

OV.RPV 

OV.RST 

OV.RWE 

OV.SRB 

OV.TBL 

OV.TDS 

OV.VSN 



Control card reader 

ECS over-commitment algorithm 

Automatic program sequencer 

CIO error message processor 

Circular I/O processor 

Tape checkpoint dump 

File CLOSE processor 

Connect file to terminal 

Common file processor 

Display processor (DSD) 

CM dump 

Permanent file dump utility 

ECS diagnostics 

Permanent file tables entry manager 
Enter time limit 



Loader control card processor 

Loader call processor 

Permanent file loader 

Move system directory (EDITLIB) 

MEMORY function processor 

Message processor (DSD) 

Add message to dayfile 

File OPEN processor 

Permanent file ATTACH processor 

Permanent file CATALOG processor 

Permanent file EXTEND and ALTER processor 

Permanent file manager (see 1PF) 
Permanent file PURGE processor 
Permanent file RENAME processor 
Permanent file SETP processor 
PERM macro processor 
REQUEST function processor 
Field length request processor 
REPRIEVE function processor 
Restore control point area for restart 

Enter expanded disk address into directory (EDITLIB) 

INTERCOM - get table in low core 

Peripheral job delay stack processor 

Process volume sequence number (control card parameter) 
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OV.XDQ PP counterpart of XXXDMPQ 

OV.XRQ PP counterpart of XXXRESQ 

OV. 1 AJ Advance job 

OV.1AU 

OV. 1BT Blank label processor — tape and disk 

OV.1CT INTERCOM queue manager-Scheduler 

OV.1CL Close file — trailer label processing 

OV. 1 DA Process family disk pack releases 

OV.1DF Dumpdayfile 

OV.1DL 

OV. 1DM Device queue manager-Scheduler 

OV.1DS 

OV. 1 EJ End-of-job and error processor 

OV. 1 EP ECS stack processor 

OV.1FC 

OV.1FM JANUS - film driver 

OV.1IB Initiate batch job from input queue 

OV.1ID 

OV.1IM 

OV. 1IQ JANUS — input queue processor 

OV. 1IR JANUS — input register processor 

OV.1IS JANUS — initialize control point 

OV.1IU JANUS - print file backspacer 

OV.1I1 

OV.1LT Load jobs from tape 

OV. IMF Multi-file positioning 

OV. 1 MH Mother's helper for DSD 

OV. 1MT Read/write other 7-track tapes 

OV.1M1 

OV.1NR Read 9-track tapes 

OV. 1 N\V Write 9-track tapes 

OV. lOP File open routine 

OV.1PC Scheduler — drop permanent file mass storage (queue manager) 

OV. 1PF Permanent file job queue manager (PFM) 

OV.1PK 

OV.1PL JANUS - plotter driver (dummy) 

OV.1PT 

OV. 1 RC Reload CM for checkpoint/restart 

OV. 1RN Scheduler — age jobs in I/O queues 

OV. 1 RP End-of-reel processing 

OV.1RS Read stranger (S) tapes 

OV. 1 RT Read standard (E) SCOPE tapes 

OV.1SI Swap or roll in a job at a control point 

OV.1SJ 

OV.1SO Swap or roll out a job at a control point 

OV. ISP Stack processor 

OV.1SX Mass storage I/O error processor 

OV. 1S5 DST ordinal checker (PP input register); Stack processor loader 
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OV.1TD 

OV.1TF 

OV.1TO 

OV.1TS 

OV.1WI 

OV.1WS 

OV.2EI 

OV.2LP 

OV.2PC 

OV.2RC 

OV.2RQ 

OV.2TA 

OV.2TB 

OV.2TC 

OV.2TJ 

OV.3DO 

OV.3PK 

OV.3TT 

OV.4ES 

OV.4LB 

OV.4LC 

OV.5DA 

OV.6BR 

OV.6BW 

OV.6CR 

OV.6CW 

OV.6LC 

OV.6LM 

OV.6MD 

OV.6SI 

OV.6WM 

OV.7EC 

OV.7SB 

OV.7T1 

OV.7T2 

OV.8AC 

OV.8M1 

OV.8M2 

OV.8PT 

OV.8SF 

OV.8SJ 

OV.8T3 

OV.9PT 

OV.9SJ 



Tape dump routine 

Move tape forward (except long record (L) tapes) 

Tape open; move tape backward (rewind) 

Scheduler — device queue manager 

Write standard (E) SCOPE tapes 

Write stranger (S) tapes 

On-line printer driver 
On-line card punch driver 
On-line card reader driver 



Write trailer label — backward tape positioning (except long record (L) tapes) 

Translate JOB card 

Allocatable device file open routine 

INTERCOM - teletype I/O processor 
Enter stack request for mass storage I/O 
Tape label processor 

Family disk pack processor 



Controls CMR directory changes 
Write error messages 



ASCII conversion table 
EBCDIC conversion table 



Load MMTC with EBCDIC conversion table for 1NR 



PAVTAPE (15) Word in CMR containing available tapes for a given configuration. 
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P.CHRQ (41) 
P.CMFL (24) 
P.CMLWA (2) 
P.CPSTAT (54) 
P.CST (5) 
P.DFB (3) 

P.DPT (14) 
P.ECSFL (27) 
P.EIRPR (11) 
P.ELBST (12) 
P.EST (5) 

P.FNT (4) 

P.HEC (4) 
P.INS (10) 
P.INT (16) 
P.LIB (1) 



P.MAIL (65) 
P.NCP (3) 
P.NOVA (3) 
P.NPP (3) 
P.PCOM (5) 



Pointer to channel request queue. 

Control memory field length/ 100. 

CMR last word address pointer. 

CPU A/B status. 

Word in CMR containing channel status table pointers. 

Address of dayfile buffer pointer word. Only the first byte (byte 0) is used; it contains 
CM address/ 10 of dayfile buffer. 

Device port table pointer. 

Machine ECS field length pointer. 

ICC pointer for ECS. 

Pointer to ECS empty page stack. 

Address of EST pointer word. Byte contains 12-bit first word address; byte 1 con- 
tains 12-bit last word address + 1. 

Address of FNT pointer word. Byte contains 12-bit first word address; byte 1 con- 
tains 12-bit last word address + 1. 

CMR location of a word containing the hardware error count. 

Address of a pointer word to an installation area; content is unspecified. 

Word in CMR pointing to INTERCOM communication areas. 

Address of library directory pointer word. Bytes and 1 contain right justified 18-bit 
first word address of library directory. Bytes 2 and 3 contain right justified 1 8-bit last 
word address plus one. Byte 4 contains a deadstart load flag; it must always be zero 
when a disk or recovery deadstart is attempted. 

Message mailbox pointer. 

CMR location of a word containing the number of control points. 

CMR location of the NOVA pointer word. 

CMR location of a word containing the number of peripheral processor units. 

PP communications area pointer word. 
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P.PFM1 (6) 
P.PFM2 (7) 
P.PFM3 (17) 
P.PJT (26) 
P.PPLIB (42) 
P.RBR (2) 

P.RBT (2) 

P.RMS (14) 

P.RPT (64) 
P.RQS (13) 



P.SCH (60) 
P.SCHPT (65) 
P.SEQ (4) 
P.STG (15) 
P.STR (61) 
P.SWPECS (65) 
P.TAPES (14) 
P.VRNBUF (43) 
P.ZERO (0) 



See P.PFM3. 

See P.PFM3. 

CMR locations of three pointer words used by the permanent file manager. 

Peripheral job table pointer. 

PP library program name table pointer. 

Address of RBR pointer word (also serves as RBT pointer word - see P.RBT). Bytes 
and 1 contain right justified 18-bit first word address of RBR table area. 

Address of RBT pointer word (also serves as RBR pointer word - see P.RBR). Byte 2 
contains first word address/2 of RBT empty chain. Byte 3 contains current length/ 
100B entire RBT area. Byte 4 contains (LWA+ 1)/ 100 of central memory. 

Word in CMR containing the pointer and length of the Rotating Mass Storage Diag- 
nostic Table. 

Removable pack table pointer word. 

Address of request stack area pointer word. Byte contains stack entry word pair 
count. Byte 2 contains first word address/2 of actual request stack. Byte 3 contains 
number of allocatable devices (N. DEVICE). Byte 4 contains FWA/10 of DST entries. 
All DST entries appear at beginning of request stack area followed immediately by 
actual request stack. 

Scheduler pointer word. 

CMR statistics table pointer. 

Word in CMR containing diagnostic sequencer pointers. 

Tape scheduler pointer word. 

Scheduler/MTR communications word. 

Swap to ECS flag word. 

Word in CMR containing the pointer and length of the Tapes Table. 

Pointer to VRN buffer table. 

Address of central memory word containing all zeros. Used by most PP routines as a 
quick means of zeroing five successive PP locations. The system is destroyed by setting 
contents of this location to non-zero. 
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Q.IUSRST 
R.DCH (627) 
R.DFM (656) 
R.EREQS (431) 
R.FAF (100) 
R.IDLE (103) 
R.MTR (544) 
R.OVL (144) 
R.OVLJ (135) 
R.PAUSE (464) 

R.PROCES (544) 
R.RAFL (464) 
R.RCH (617) 
R.READP (316) 
R.RWP (342) 
R.RWPP (356) 
R.STB (650) 
R.STBMSK (641) 
R.TAFL (517) 
R.TFL (533) 

R.WAIT (555) 
R.WRITEP (325) 
S.ACTION (6) 



User tape identifier in INTERCOM user table. 

PP resident routine to drop a channel. 

PP resident routine to transmit a dayfile message. 

PP resident routine to access a request stack. 

PP Resident cell which contains the field access flag. 

PP resident idle loop. 

PP resident routine to process a request for MTR. 

PP resident routine to load a PP overlay. 

PP resident routine to load a PP overlay and transfer control to it. 

PP resident routine to test control point storage move flag and to pause until comple- 
tion of the move. 

Identical with R.MTR. 

PP resident routine to process requests to access control point field length. 

PP resident routine to process requests to reserve a channel. 

PP resident routine to read data via channel from Stack Processor. 

Special entry point to R.READP used by LDR. 

Word in R.READP modified by LDR. 

PP resident routine to perform a masking operation using specified words. 

Address within PP Resident of a mask used by R.STB routine. 

PP resident routine used to terminate access of a control point field length. 

PP resident routine to insure that a relative address is within the control point field 
length. 

PP resident routine to idle until output register clears. 

PP resident routine to write data via channel to Stack Processor. 

Action (DS parameter byte). 
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S.APFIL (1) 
S.CPA (2) 
S.CPCLR (66) 
S.CPDP (6) 
S.CPE (13) 

S.CPEOJ (65) 
S.CPF (0) 

S.CPEVNT (6) 
S.CPFFL (64) 
S.CPFLG (7) 
S.CPG (1) 

S.CPJ (11) 
S.CPJFL (10) 
S.CPLDAF (0) 
S.CPL1 (4) 
S.CPLL (2) 
S.CPLM (6) 
S.CPLP (1) 
S.CPLR (5) 
S.CPLT (4) 
S.CPLW (12) 
S.CPN (4) 



APF table interlock (C.PFMCH) 

Right offset of rerun bit in byte C.CPFP of the control point area. 

Control point clear request. 

Right offset of private pack bit in byte C.CPFP of the control point area. 

Right offset of the EXPORT/IMPORT bit in byte C.CPFP of word W.CPERT of the 
control point area. 

End of job flag. 

Right offset of the reprocess control card bit in byte C.CPFP of word W.CPERT of the 
control point area. 

Swapout event bit in W.CPSWP. 

Flags FNTs in positive FL (bit in W.CPSCH of JCA). 

Right offset of the CP loader flag. If set, the CP loader is being used. 

Right offset of the abort bit in byte C.CPFP of the control point area. This bit is set by 
1AJ if a control card error occurs or if the user tries to load the binary output of an 
assembly or compilation which had errors. 

JANUS bit for DSD. 

Job card field length assigned bit. 

Directory access flag offset. 

Incomplete load flag. 

Library load bits. 

Map flag bits. 

System routine protection bits. 

Reduce flag. 

Trap debugging and flag. 

Loader type flag. (Which loader to be used.) 

Right offset of the checkpoint bit in byte C.CPFP of the control point area. This bit is 
set if a valid checkpoint has been taken. 
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S.CPNFNT (3) 
S.CPNO (0) 
S.CPR (12) 

S.CPRFL (67) 
S.CPROP (70) 
S.CPS (30) 

S.CPSIP (71) 
S.CPSOP (72) 
S.CPSWC (73) 
S.CPUSTA (2) 
S.CPUSTB (3) 
S.CPUSTC (7) 
S.CPUSTD (10) 
S.CPUSTM (0) 
S.CPUSTP (12) 
S.CPUSTR (6) 
S.CPUSTS (11) 
S.CPUSTW (5) 
S.CPUSTX (4) 
S.CPUSTY (1) 
S.CPX (5) 

S.CPYES (1) 



1AJ should skip FNT search. 

Flag set by DSD on NO type-in. 

Right offset of the INTERCOM bit in byte C.CPFP of the control point area. This bit 
is set for all INTERCOM jobs. 

Storage request in progress flag. 

Rollout is in progress flag. 

Right offset of the sequencer bit in byte C.CPFP of the control point area. Bit is set to 
indicate input file is not to be purged. 

Swap in is in progress. 

Swap out is in progress. 

Swap out is complete. 

Run in CPU-A only status. 

Run in CPU-B only status. 

Currently assigned to CPU-A status. 

Currently assigned to CPU-B status. 

Suspended for storage move status. 

Suspended for checkpoint status. 

Suspended for real time status. 

Suspended for swapout status. 

Waiting for CPU (unless suspended) status. 

Recall status. 

Automatic recall status. 

Right offset of the exit bit in byte C.CPFP of the control point area. This bit is set 
whenever 1AJ encounters an exit card. 

Set by DSD when YES type-in received. 
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S.CP1IB (63) 
S.DIRPR (10) 

S.DIRPT (4) 

S.ECIOT (11) 
S.ECSB (13) 
S.EDTRUN (1) 
S.ESTBSY (4) 
S.ESTFR (5) 
S.ESTPF (10) 
S.ESTPFD (7) 
S.ESTRMS (13) 
S.ESTSYS (6) 
S.EVJST (57) 
S.FECS (5) 
S.FEXNEW (6) 
S.FINDXW (6) 
S.FLINK (4) 
S.FLOCK (5) 
S.FMUJ (3) 
S.FNTEQP (6) 

S.FNTWRT (7) 
S.FPFREW (2) 
S.IEDIT (13) 



1 IB operating at control point. 

Number of bit positions to right shift in PP word to right justify program residence to 
bit zero. 

Number of bit positions to right shift in a PP word to right justify the program type to 
bit zero. 

ECS buffer type in C.ECFLG. 

ECS buffer active flag in C.ECFLG. 

Set in C.DSFLAG every time EDITLIB runs. 

Private device busy bit in EST. 

Private device free bit in EST. 

Public device/permanent file device bit in EST. 

Public device/permanent file directory device bit in EST. 

RMS device bit in EST. 

Public device/system device bit in EST. 

Job status modified flag in word 4 of PP message buffer. 

Uppermost of 2 ESS flags in FST. 

E/N bit in FNT. 

Index write bit in FNT. 

Link bit in FNT first word. 

Lock bit in FNT first word. 

Multi-user job bit in FNT. 

Right offset of equipment code field in FNT. Equipment code field is positioned in bits 
6-11 of byte zero. 

Write bit in FNT. 

Permanent file rewrite bit in FNT. 

INTERCOM/EDITLIB flag. 
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S.ILKOUT (13) 
S.ILOGO (5) 
S.I.MUJ (13) 
S.INTC (2) 
S.INTH (1) 
S.INTL (0) 
S.ISTATE (7) 
S.IUCCP (6) 
S.IUDMP (7) 
S.IUECS (11) 
S.IUEOE (6) 
S.IUFNT (12) 
S.IUPS (10) 
S.IURED (13) 
S.I1I1 (12) 
S.JDBCB (43) 
S.JDECS (36) 
S.JDEXP (22) 
S.JDGO (21) 
S.JDGR (3) 
S.JDINT (5) 
S.JDLGI (41) 
S.JDLGO (40) 
S.JDLOK (17) 



INTERCOM lockout flag. 

INTERCOM login/logout flag. 

INTERCOM user attached to MUJ. 

INTERCOM LCC up/drop flag. 

INTERCOM high speed up/drop flag. 

INTERCOM low speed up/drop flag. 

INTERCOM user status. 

INTERCOM control cards processed flag (C.IUCCA). 

INTERCOM dump flag (C.IUFILE). 

INTERCOM swap file on ECS flag (C.IUFILE). 

INTERCOM end of job flag (C.IUFILE). 

INTERCOM FNTs to be gathered flag (C.IUFILE). 

INTERCOM pause flag (C.IUFILE). 

INTERCOM value for S.CPLR in CP area (C.IUFILE). 

INTERCOM initialization flag. 

Job recovery occurred (C.JDFLG). 

Swap file on ECS (C.JDFLG). 

Job is for express queue (C.JDOPF). 

Operator typed GO (C.JDOPF). 

Job origin (Graphics bit). 

Job origin (INTERCOM bit). 

Job LOGIN command (C.JDFLG). 

No swap file needed (C.JDFLG). 

Job not to be brought to control point (C.JDOPF). 
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S.JDMUJ (4) 
S.JDNFNT (33) 
S.JDNJ (37) 
S.JDNRR (42) 
S.JDNS (20) 
S.JDROLL (34) 
S.JDRT (2) 
S.JDSKFL (35) 
S.LBLLVL (12) 
S.NXJSR (42) 
S.PFDEU (3) 
S.PFDIL (2) 
S.PFLVL (11) 
S.PFUTIL (4) 
S.RBRUNT (6) 
S.RBTCIL (3) 
S.RBTCW (0) 
S.RBTDEV (13) 

S.RBTEST (12) 

S.RBTNEW (10) 
S.RBTOVF (7) 

S.RBTPFD (11) 



Job origin (multi-user job bit). 

FNT search inhibited (C.JDFLG). 

New job in INTERCOM area (C.JDFLG). 

Job cannot be rerun (C.JDFLG). 

Job cannot be swapped or rolled (C.JDOPF). 

Job cannot be swapped out (C.JDFLG). 

Real time job (C.JDORG). 

Skip fl on swap file (C.JDFLG). 

RMS label level (DS parameter byte). 

Storage request flag. 

PFD entry in use (C.PDFLAG). 

Permanent file directory interlock (C.PFMCH). 

Permanent file level (DS parameter byte). 

Utility interlock (C.PFMCH). 

Right offset of DST ordinal field in RBR header. 

RBTC I/L offset in byte C.PFMCH in word P.PFM1. 

RBTC wraparound offset in byte C.PFMCH in word P.PFM 1 . 

Right offset of the bit that indicates whether the file was assigned by device type in 
byte 2 of the first word of the first RBT word pair in a chain. 

Right offset of the bit that indicates whether the file was assigned by EST ordinal in 
byte 2 of the first word of the first RBT word pair in a chain. 

Right offset of new RBT flag bit in flag field of RBT word pair. 

Right offset of the overflow bit in byte 2 of the first word of the first RBT word pair in 
a chain. 

Right offset of the permanent file flag bit in byte 2 of the first word of the first RBT 
word pair in a chain. 
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S.RBTRBR (3) 
S.RBTREL (7) 
S.RBTRND (6) 
S.RBTSAM (5) 
S.STECS (0) 
S.STF (6) 
S.STFA (0) 
S.STFEOF (4) 
S.STFETP (2) 
S.STFNTP (3) 
S.STFPRI (5) 
S.STFREL (4) 
S.STFXCT (1) 

S.SYSEDT (0) 
S.SYSLVL (7) 
S.TRANIL (6) 
T.CLK (30) 

T.CPA1 (200) 
T.CPJOBN (26) 
T.CPSTA (44) 
T.CPSTB (45) 
T.CPT1 (56) 



Right offset of RBR ordinal field in RBT word pair. 

Right offset of release bit in flag field of RBT word pair. 

File organization is random (C.RBTBIT). 

File organization is index-sequential or direct access (C.RBTBIT). 

ECS flag bit in stack request. 

Right offset of flag field in a stack request. 

Right offset (in the flag field) of PP-available bit in a stack request. 

Right offset (in flag field) of end-of-file bit in stack request. 

Right offset (in flag field) of FET-present bit in stack request. 

Right offset (in flag field) of FNT-present bit in stack request. 

Right offset (in flag field) which specifies high priority for this stack request. 

Right offset (in flag field) of release bit in stack request. 

Right offset (within the flag files) of the exaxt bit in byte C.STFB of word W.STFB of 
a request stack entry. Offset is relative to S.STF. 

Bypass MDI GO/DROP message (C.DSFLAG). 

System level flag (DS param byte). 

TRANSPF interlock. 

Location in which clock is kept, in form HH.MM.SS. T.CLK is updated by MTR and 
displayed on top line of left scope. Time will be time of day, if a time entry to DSD 
was made; otherwise, it will be the time since deadstart. 

Control point area address of control point 1 . 

CMR location of a pointer word containing the job sequence number and job count. 

CPU-A control word. 

CPU-B control word. 

Location of the CPU activity status. CPU A status is in byte 4, CPU B status is in byte 
3. The activity status is the control point area address of the program currently using 
the CPU (0000 for idle). 
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T.DATE (31) 
T.ECSPAR (57) 



T.EPBL (27) 
T.JDATE (20) 

T.MSC (40) 



T.MSP (37) 

T.MXNCTL (46) 
T.PPID (47) 
T.PPIP (50) 
T.PPS1 (154) 



Location of today's date in the form entered by operator at deadstart time. Date is 
displayed on top line of left scope. 

This word contains in bytes 
0,1 Zero. 



An ECS flaw table full flag. It is set when a flaw count overflow is 
detected during as ECS transfer (by ICEBOX). 

An ECS parity flag which can assume values of 2 or 4. It is set 
when a parity error is detected during an ECS storage move, and 
indicates whether 1 or 2 control points shall have their error flags 
set to F.ERECP. The control point requesting the ECS will always 
have its error flag set. In the case of storage overlap and the 
occurrence of the parity error in the part of ECS which belongs to 
another control point, the flag will have the value 4. After the flag 
is set, DSD will display a message stating that an ECS parity error 
has occurred and MTR will not assign ECS anymore. These con- 
ditions shall prevail until the next deadstart. 

4 This byte contains the address of the block in ECS/ 1000 in which 

the parity error occurred. DSD will display this value as above. 

ECS page and buffer length. 

Location of today's date in Julian format. Value is computed from date entered by 
operator at deadstart time. 

Contains the time to the millisecond since deadstart. 



Byte 1 
Byte 2 
Byte 3-4 



Time in seconds (reset each 2**12 seconds) 
Milliseconds since updating the seconds 
Time in msec (reset each 2**24 msec). 



Location of Monitor step flag used for communication between DSD and MTR while 
system is in step mode. 

MXN control word. 

PP identification for MXN to CPMTR. 

PPMTR function pointer. 

Location of the PP status word. Byte contains the control point area address of the 
control point to which the PP is assigned. T.PPS0 (52) is used by MTR as a scratch 
memory word. 
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T.PPSO (52) 

T.RCHN (55) 

T.SCHCP (62) 

T.SCHPP (63) 

T.SLABx (31-36) 
(x-1-6) 

T.UAS (56) 



Pointer to control point area to which PP is assinged. 
Location of the first RBT word pair to be released. 
Scheduler interlock word. 
PP interlock word for scheduler use. 

Locations containing system label displayed on top line of left scope. 

Location of unassigned storage length. MTR keeps tally of size of the holes between 
control points in T.UAS; IRA uses this size to determine whether or not there is 
adequate central memory to bring a given job to a control point. 



Byte 
Byte 1 



Central Memory UAS 
ECS UAS 



W.CHTIM (65) 
W.CKP (52) 
W.CPAR (60) 
W.CPCAF (70) 

W.CPCAL (167) 

W.CPCC (26) 
W.CPCKP (52) 
W.CPDFM (30) 

W.CPDFMC (62) 
W.CPDPV (62) 
W.CPECS (27) 

W.CPEF (24) 
W.CPERT (63) 



Relative word in control point area giving channel I/O time. 

Relative word in control point area contain checkpoint parameters for a job. 

Relative word in a control point area which contains the auto-recall register. 

Relative first word address in a control point area of the 100B word buffer containing 
current control cards. 

Relative LWA in a control point area of a 100-word buffer containing current control 
cards. 

Relative word in control point area containing reprieve function address. 

Checkpoint parameter word. Same as W.CKP. 

First of eight words in a control point area containing dayfile message currently on the 
B display. 

Word in the control point area containing the dayfile message count. 

Relative word in a control point area containing the job dependency count and ID. 

Relative word in a control point area containing ECS field length/ 1000 and ECS RA/ 
1000 assigned to a job. 

Relative word in a control point area containing error flags for job. 

Relative word in a control point area containing internal flags used by job processing 
routines. 
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W.CPFACT (50) 
W.CPFL (24) 

W.CPFLAG (63) 
W.CPFP (63) 
W.CPFST (51) 
W.CPINS (170) 

W.CPINT (41) 

W.CPIRB (62) 
W.CPJCP (40) 
W.CPJNAM (25) 
W.CPLDR1 (55) 
W.CPLDR (55) 
W.CPLDR2 (56) 
W.CPLDR3 (57) 
W.CPLINK (20) 
W.CPMSI (66) 
W.CPMSLM (64) 
W.CPOAE (53) 

W.CPOUT (63) 

W.CPPRI (40) 
W.CPPTM (23) 



Control point word containing permanent file accounting parameter. (Same as W.ID). 

Relative word in a control point area containing memory field length/ 100 assigned to 
the job. 

Relative word in a control point area containing various flags. 

Job processing flags. See W.CPFLAG. 

FNT positioning information for job input file. (Same as W.FSTCC). 

Relative first word address in a control point area of an 8-word zone reserved for 
installation use. 

Relative word in a control point area containing INTERCOM status and communica- 
tion information. 

Control point area word containing INTERCOM user ID. 

Word in the control point area containing job card parameters. 

Relative word in control point area containing seven-character job name. 

Same as W.CPLDR. 

Relative word in control point area containing various loader flags. 

Library set information (global set) for loader use. 

Loader global set information word 2. 

Active control point link word. 

Relative word in a control point area containing the INTERCOM PP recall register. 

Relative word in a control point area containing mass storage limit information. 

Relative word in control point area containing byte used to communicate operator- 
assigned equipment. MTR sets EST ordinal of equipment requested by DSD in this 
byte for subsequent testing by REQ. 

Relative word in control point area which contains an output file flag in bvte 
C.CPOUT. 

Relative word in control point area containing current job priority. 
PP time word in control point area. See C.PPTIME. 
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W.CPRO (42) 
W.CPSCH (42) 
W.CPSLIC (20) 
W.CPSR (67) 
W.CPSSW (43) 
W.CPSTAT (24) 
W.CPSTG (61) 
W.CPSWP (41) 
W.CPTAPE (61) 
W.CPTIMB (22) 
W.CPTIME (21) 
W.CPTIML (40) 
W.CPUST (20) 
W.CPVRNO (54) 

W.FAPF (0) 
W.FCS (2) 
W.FEQP (1) 
W.FSTCC (51) 

W.ICOM (0) 
W.ID (50) 
W.IENDLS (1) 
W.IHUSR (44) 



Relative word in a control point area containing the roll-out flags. 

Scheduler information for current job at control point. 

Maximum CPU time slice allowed for job. 

Relative word in a control point area containing outstanding stack requests. 

Word contains sense switch bits. 

Relative word in control point area containing status byte. 

Tape staging parameters are in this word. (Same as W.CPTAPE). 

Job swapping control word. 

Relative word in a control point area containing the available tape status. 

Relative word in control point area containing CPU-B time accumulated by job. 

Relative word in control point area containing CPU-A time accumulated by job. 

Relative word in control point area containing CP time limit imposed on the job. 

CPU status word in control point area. 

Relative word in control point area which transmits private pack visual reel number 
typed by operator to tape labelling routine. 

FNT word containing APF pointer for file. 

Code and status word offset in FNT. 

Equipment code word offset in FNT. 

Relative word in control point area containing FST entry (FNT word 2) for job input 
file. Contents of this word designate position on device at which next PRU of control 
cards may be found. (Same as W.CPFST). 

INTERCOM /SCOPE communications word. 

Relative word in control point area containing the owner ID. (Same as W.CPFACT). 

INTERCOM low speed word. 

INTERCOM high speed user table pointer. 
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W.IINS (17) 
W.IMNAME (1) 
W.IUAGP (15) 
W.IUAPP (14) 
W.IUEQP (10) 
W.IUFST (3) 
W.IUMUJ (2) 
W.IUSER (27) 
W.IUSTA (0) 
W.JDDSD (2) 
W.JDINT (4) 
W.JDLNK (0) 
W.JDMGR (3) 
W.JDNAM (0) 
W.JDSWP (1) 
W.LBCK (7) 
W.LBDATE (0) 
W.LBFLAW (10) 
W.LBID (0) 
W.LBPFD (2) 
W.LBPRIV (3) 
W.LBRBR (4) 
W.LBRBTC (2) 
W.LBVID (1) 



INTERCOM installation word. 

Multi-user job name word for INTERCOM. 

CP time field for INTERCOM user. 

PP time field (INTERCOM). 

INTERCOM user equipment word. 

INTERCOM communication word with swapper. 

INTERCOM MUJ word. 

INTERCOM user ID word. 

INTERCOM user table header word. 

Third word of job descriptor entry. Communication with DSD. 

Fifth word of job descriptor entry when IP.INTCM is not zero. 

First word of job descriptor entry (also W.IDNAM). Link to next JDT entry. 

Fourth word of job descriptor entry. Manager/scheduler communications. 

First word of job descriptor entry (also W.JDLNK). Job name. 

Second word of job descriptor entry. Swapper word. 

Relative location in the device label of the word containing the label checksum. 

Relative location in the device label of the word containing the date. 

Relative location in the device label of word containing first word of RBR header. 

Relative location in the device label of the word containing the label ID. 

Relative location in the device label of the word containing the PFD pointer. 

Relative location in the device label of the word containing private pack information. 

Relative location in the device label of the word containing RBR ordinal. 

Relative location in the device label of the word containing the RBTC pointer. 

Relative location in the device label of the word containing the visual ID. 
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W.PPIR (0) 



Relative word in a PP communication area containing PP input register. 



W.PPMESx (2-7) 
(x=l-6) 

W.PPOR (1) 

W.PPTIME (23) 

W.RBRLAV (1) 

W.RBRTPA (0) 
W.RBRUNT (0) 
W.RWPPCW (2) 

W.SCHIR (0) 
W.SCHOR (1) 
W.SCHRS (2) 
W.SSW (43) 

W.STCPU (0) 

W.STEI (0) 

W.STFB (1) 
W.STGFRE (1) 
W.STGMAX (0) 
W.STGSAT (3) 
W.STGUFD (2) 
W.STO (0) 
W.STPFW (1) 



Relative word in PP communication area containing six-word PP message buffer. 

Relative word in PP communication area containing PP output register. 

Relative word in control point area containing total PP time accumulated by job. 

Relative word in RBR header word containing count of record blocks logically 
available. 

Relative word in RBR header containing equipment type and allocation style. 

Relative word in RBR header containing unit number (DST ordinal). 

Relative position of READP/WRITEP communication word in message buffer of PP 
communication area. 

Scheduler input register displacement. 

Scheduler output register displacement. 

Scheduler request stack displacement. 

Relative word in control point area containing sense switch settings for job. (Same as 
W.CPSSW). 

Relative word in stack request containing control point and unit number (DST ordi- 
nal) of request. 

Relative word in stack request containing empty indicator. 

If this field is 0, the entry is not in use. 

Word in stack request which contains flag byte. 

Indicates units not assigned and on. 

Maximum units defined in CMR. 

Units held by satisfied jobs. 

Indicates unfilled demands for units. 

Word in stack request which contains stack processor order. 

Word in stack request which contains next address in PP memory for data transmis- 
sion. Field is used in this manner only on calls to R.READP or R.WRITEP. 
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W.STPLW (1) 

W.STPMS (1) 
W.STPPRU (0) 

W.STPRBA (0) 

W.STPRBN (0) 

W.STPWC (1) 

W.TFLGS (5) 
W.TFLN1 (1) 

W.TREEL (4) 
W.TVRN (6) 

W.TVRN1 (7) 

W.XPIR (24) 
W.XPOR (25) 
W.XPRS (26) 
X.ECOVL (4) 
X.ICE (2) 
X.SCH (5) 
X.SCH2 (6) 
X.SPM (3) 



Word in stack request which contains LWA +1 in PP memory for data transmission. 
Field is used in this manner only on calls to R.READP or R.WRITEP. 

Word in stack request which contains PP message buffer address. 

Word in stack request which contains PRU number at which to begin data transmis- 
sion if no FNT is specified. 

Word in stack request which contains address of RBT word pair containing record 
block at which to begin data transmission if no FNT is specified. 

Word in stack request which contains RBT ordinal of record block at which to begin 
data transmission if no FNT is specified. 

Word in stack request which contains number of PP words (bytes) to be transmitted 
during a READP or WRITEP request. 

Relative word in a Tapes Table entry containing flags used by tape routines. 

Relative word in a Tapes Table entry containing the first 10 characters of the label 
name. 

Relative word in a Tapes Table entry containing the reel number. 

Relative word in a Tapes Table entry containing the visual reel number of the current 
reel. 

Relative word in a Tapes Table entry containing the visual reel number of the first 
reel. 

Exchange package input register. 

Exchange package output register. 

Request stack for scheduler exchange packages. 

Executive processor ECS code. 

Executive processor ICEBOX code. 

Central executive code for scheduler used when storage request is rejected. 

See X.SCH. 

Executive SPM code. 
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PPSYS MACROS 

LDK MACRO 

Generates LDN, LDC, or LCN instruction depending on size of its argument, which may be any valid 
address expression. Recommended for referencing SCPTEXT symbols for CM pointer words. 

ADK MACRO 

Generates ADN, ADC, SBN, or no instruction depending on size of its argument, which may be an address 
expression. Recommended for referencing SCPTEXT symbols for relative positions in control point tables 
(W.x symbols). 

SBK MACRO 

Generates SBN or ADC instruction, depending on size of its argument. Any symbols used in its argument 
must be denned. 

UJK MACRO 

Generates UJN or LJM instruction, depending on length of jump. In general, the jump must be backward, 
since symbols used in address field must have been previously defined. Macro is useful for exiting from 
small subroutines subject to expansion. 

BIT MACRO 

Generates no code; merely defines the symbol in the location field. Value assigned to symbol is a 1-bit mask 
where the bit is positioned according to the value of address field. Bits are counted in the standard manner, 
from right to left, beginning with zero. Thus, the statement MASK BIT 2 would set MASK equal to 4. 
Macro is useful for generating 1-bit flag values with the S.x SCPTEXT symbols. 

ENM MACRO 

Generates standard PP subroutine entry and exit lines. The subroutine name is that declared in location 
field of ENM; subroutine may be entered by an RJM to that name. If address field of ENM is blank, no 
exit symbol is defined; otherwise, address field contents are appended to location symbol to generate 
subroutine exit symbol. (Typically, address field contains only an X) An exit from subroutine may be made 
by jumping directly to the generated symbol. 

PPENTRY MACRO 

Used as first instruction following ORG in a primary level overlay. PPENTRY generates code to set up low 
core parameter as follows: 
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D.PPIRB through D.PPIRB + 4 Input register contents 

D.RA Reference address/ 100 8 

D.FL Field length/ 100 8 

The macro also sets the field access flag in the control point area. Address field of the PPENTRY macro 
must always contain: D.PPIRB, D.TO or an error will result. 

LDCA MACRO 

The macro loads PP A register with absolute 1 8-bit central address. Relative CM address is obtained from 
two consecutive PP low core locations; the first is specified in address field of LDCA macro. CM address is 
assumed to be right justified within these two words. Contents of D.RA are added to CM address. Macro is 
useful for loading many different CM addresses. Space may be conserved by using a subroutine rather than 
a macro if the same address is to be loaded three or more times. 

CRI MACRO 

Reads contents of a CM word whose address is contained in a central memory pointer. Address field of 
CRI macro contains X, Y, and Z subfields, in that order. 

X 6-bit CM pointer word address 

Y First of five PP locations into which the desired CM word will be read. 

Z Byte within CM pointer word containing 12-bit CM address of desired word, counting 

from zero to 4. 

CEQU MACRO 

If symbol in label field has not been previously defined, sets the symbol equal to the value in operand field; 
otherwise the macro is a no-operation. 

CMICRO MACRO 

Acts as a MICRO instruction to define the symbol in label field if label has not been previously defined; 
otherwise the macro is a no-operator. 

JOBCARD MACRO 

SCPTEXT contains a definition of a macro called JOBCARD. The release version is empty, consisting of a 
macro definition header and a terminator. System characteristics may be altered by an installation by 
inserting (between header and terminator) one or more cards as described below. 

If the symbol SCOPE 2.0 is defined in JOBCARD, SCOPE 3.4 is altered to accept only SCOPE 2.0 job 
cards. The value to which the symbol SCOPE 2.0 is equated is irrelevant 
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SCOPE 3.4 may be altered to accept a decimal value on one or more of the job card parameters by 
inserting a card in the following form: 

DECIMAL field 

where field is one of the terms EC, CM, T, P, D, TP, MT, or NT. Currently, all values are assumed to be 
octal; however, it may be declared specifically that a parameter is to be interpreted as octal by inserting a 
card in the following form: 

OCTAL field 
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